可以这么理解,但它不只是个简单的“静态网站发布工具”,它更像一个「为 Obsidian 笔记量身打造的静态网站生成器」。

我用通俗的话给你拆开讲清楚: #学习/个人网站/Quartz

✅ 它确实能做的:发布静态网站

你现在运行 npx quartz build 生成的 public 文件夹,就是一套完整的静态网站文件。

  • 这些文件可以直接上传到任何支持静态文件托管的地方(GitHub Pages、Vercel、你的服务器)
  • 只要配置好域名,就能用你自己的网址访问
  • 这一点上,它和 Hexo、Hugo 这类静态博客工具是一样的

✨ 但它的核心,是「为 Obsidian 笔记做优化」

它和普通静态网站工具最大的区别,就是专门为 Obsidian 的笔记生态做了深度适配:

  1. 完美支持 Obsidian 的双链、嵌入、标签、目录结构 比如你笔记里的 [[链接]],它会自动转换成网站里的跳转链接;文件夹结构会自动变成网站的目录导航。
  2. 自带 Obsidian 用户喜欢的功能
    • 双向链接、反向链接列表
    • 全局搜索、站内标签页
    • 笔记关系图谱(就是 Obsidian 里那个很火的图)
    • 支持 Callout、代码块、Mermaid 流程图等 Obsidian 原生语法
  3. 一键同步更新 你在 Obsidian 里写好笔记,扔到 content 文件夹,一条 npx quartz sync 命令就能自动构建、发布,不用手动处理复杂的配置。

📌 一句话总结

  • 它的底层能力,是生成和发布静态网站。
  • 它的核心定位,是「Obsidian 笔记的专属发布工具」,帮你把本地笔记一键变成一个功能强大、样式美观、能公开访问的知识库网站。

如果你想,我可以帮你对比一下它和 Hexo/VuePress 这类工具的区别,让你更清楚它适合不适合你的使用场景。

相关链接

quartz就是发布静态网站的吗 | Quartz 生成的静态网站 | 步骤1