可以这么理解,但它不只是个简单的“静态网站发布工具”,它更像一个「为 Obsidian 笔记量身打造的静态网站生成器」。
我用通俗的话给你拆开讲清楚: #学习/个人网站/Quartz
✅ 它确实能做的:发布静态网站
你现在运行 npx quartz build 生成的 public 文件夹,就是一套完整的静态网站文件。
- 这些文件可以直接上传到任何支持静态文件托管的地方(GitHub Pages、Vercel、你的服务器)
- 只要配置好域名,就能用你自己的网址访问
- 这一点上,它和 Hexo、Hugo 这类静态博客工具是一样的
✨ 但它的核心,是「为 Obsidian 笔记做优化」
它和普通静态网站工具最大的区别,就是专门为 Obsidian 的笔记生态做了深度适配:
- 完美支持 Obsidian 的双链、嵌入、标签、目录结构
比如你笔记里的
[[链接]],它会自动转换成网站里的跳转链接;文件夹结构会自动变成网站的目录导航。 - 自带 Obsidian 用户喜欢的功能
- 双向链接、反向链接列表
- 全局搜索、站内标签页
- 笔记关系图谱(就是 Obsidian 里那个很火的图)
- 支持 Callout、代码块、Mermaid 流程图等 Obsidian 原生语法
- 一键同步更新
你在 Obsidian 里写好笔记,扔到
content文件夹,一条npx quartz sync命令就能自动构建、发布,不用手动处理复杂的配置。
📌 一句话总结
- 它的底层能力,是生成和发布静态网站。
- 它的核心定位,是「Obsidian 笔记的专属发布工具」,帮你把本地笔记一键变成一个功能强大、样式美观、能公开访问的知识库网站。
如果你想,我可以帮你对比一下它和 Hexo/VuePress 这类工具的区别,让你更清楚它适合不适合你的使用场景。