数字工具实践录

用 Quartz 搭建个人知识库站点

2026-07

Quartz 是一个基于 Obsidian Markdown 的静态站点生成器。它的核心优势是原生支持 WikiLink、frontmatter、callout 和 Obsidian 嵌入语法，不需要额外适配就能把 Obsidian vault 发布为网站。

发布契约

我的知识库里有 66 篇 Markdown，但不是所有内容都应该公开。Quartz 的 ExplicitPublish 过滤器读 frontmatter 的 publish 字段：

publish: [quartz]   # 构建时输出
publish: []          # 私有，不输出

这意味着同一批文件可以同时作为 Obsidian vault 和公开站点，私有内容不会泄露到构建产物中。

分层架构

知识层（Knowledge）是唯一真相，Artifacts 是它的构建结果。Quartz 是 Artifact 的一种，不是编辑器。这个约束保证了内容始终有单一真相来源，不会出现"网页改了但 Markdown 没改"的漂移。

定制

Quartz 的组件系统基于 TSX，可以自定义 Footer、Head、Sidebar 等。我在 Footer 里加了 ICP 备案号和公安联网备案链接，把 GitHub 链接指向自己的仓库。baseUrl 设为实际域名，确保 sitemap 和 RSS 生成正确。