写作只发生在 Obsidian 里:新建笔记、打上 publish: true、推送,站点就更新了。这篇文章本身就是这条链路的测试用例。

发布流程没有后台、没有编辑器、没有数据库,唯一的动作是往 vault 里提交一个合规的 markdown 文件。

链接语法

正文里可以直接用双链指向其他笔记,比如 数字花园,也可以带别名写成 我的花园

指向未发布笔记的链接会降级为纯文本,比如这个:未发布的草稿,不会产生死链。

Callout

图片

本地附件嵌入语法:

R2 图床的标准 markdown 语法:

占位示意图

代码

// 等宽字体 + 暗色主题在阶段 3 落实
const publish = (note) => note.frontmatter.publish === true;

不支持的语法

下面这个 dataview 查询块应当在构建时被静默移除,并在构建日志中告警:

以上各项的渲染效果都属于阶段 2 的验收范围。