这是什么?
Quartz 是一个静态网站生成器,可以把 Markdown 笔记变成功能完整的网站,特别适合发布“数字花园”和相互链接的笔记。
这是独立应用,还是我用来处理自己笔记的工具?
它是一个通过命令行运行的静态网站生成器:你对存放 Markdown 文件的文件夹(通常是 Obsidian 库)执行构建命令,它就会输出可以直接部署的网站。
我该怎么用 Quartz 把网站跑起来?
先通过 quartz 命令行工具(./quartz/bootstrap-cli.mjs)完成初始化,然后用类似 'npx quartz build --serve' 的命令在本地构建并启动服务,同时把它指向你的 Markdown 内容文件夹。
试用 Quartz 之前需要先安装什么?
需要 Node.js 22+ 和 npm 10.9.2+;不需要 Python、Go 或 Rust。
它只能用于 Obsidian 库,还是任何 Markdown 笔记都可以?
它主要围绕 Obsidian 风格的 Markdown 设计(仓库的话题标签明确提到了 obsidian 和 obsidian-md),因此用这种风格写的笔记效果最好,不过普通 Markdown 也支持。
生成的网站可以放在任何地方托管吗,还是 Quartz 必须用特定的托管服务?
README 没有详细介绍托管方式,但由于它输出的是静态网站,可以部署到任何静态托管服务上(例如 GitHub Pages、Netlify、Cloudflare Pages)。
Quartz 支持插件系统吗?
支持。它附带一套可安装的插件生态,依赖列表中的社区插件(如 backlinks、breadcrumbs、citations 和 canvas 页面渲染器)就是例子。
“networked thought”对这个工具来说是什么意思?
指的是 Quartz 注重保留笔记之间的链接(例如反向链接和文章之间的关联),让发布出来的网站体现你知识库中相互关联的结构,而不只是一个个孤立的页面。
运行 Quartz 有 Docker 方式吗?
有。仓库包含 Docker 支持,还有专门的 docker-build-push CI 工作流,用于构建和发布 Docker 镜像。
What are similar projects?
claude-obsidian, obsidian-git, obsidian-releases, obsidian-second-brain, claudian, chubbyskills, pickoo-your-favorites, siyuan
Which topics is it in?
obsidian-md, publishing, obsidian-plugin, personal-knowledge-management, obsidian, static-site-generator, note-taking, knowledge-base, markdown, productivity, npm, nodejs