🦾 极客工具

obsidian-quartz

6分钟阅读

一键发布知识图谱：Obsidian 与 Quartz 的高效协作

作为一名 Obsidian 深度用户，我一直在寻找将数字花园「一键绽放」的解决方案。今天测评的 Quartz，让我找到了知识图谱「写即发布」的自动方案！

Obsidian 手搓知识图谱，Quartz 承包华丽变身。

项目速览

🔖 Quartz 是一款开箱即用、高度可定制的静态网站生成器，专为构建双链笔记/知识图谱形式的和知识库设计，支持 Markdown 快速转换为功能完整的网站。

  • 🌐 官方地址：github-quartz
  • 👨 维护现状：8k star，项目活跃，最近更新 于 2025-02-11。
  • 📌 核心价值：
    • 零配置开箱即用：传统 Hexo/Hugo 需要配置主题 + 搜索 +SEO，Quartz 一键生成站点
    • 知识图谱可视化：自动解析双向链接，生成思维导图式导航

场景定位

推荐人群

  • 强烈建议 Obsidian/Logseq 类双链笔记用户使用
  • 想无压力共享个人知识图谱的内容生产者
  • 技术博主需要 Git 驱动 + 自动化部署
  • 厌恶 CMS 系统的极简主义者

慎入情况

  • 需要动态评论/会员系统
  • WordPress 式可视化编辑器依赖者
  • 完全不懂 git, nodejs 的小白

技术透视

技术架构

  • 前端框架：Preact.js（React 同构 API 的轻量替代方案）
  • 实时构建体系：双 esbuild 实例（服务端/客户端分离处理） + Lightning CSS 压缩，实现毫秒级热更新

设计哲学

  • 渐进式复杂度设计
    • 默认配置实现零成本启动（npx quartz create 初始化模板）
    • 高级用户可通过 quartz.config.ts 解锁原子级控制
  • 性能与灵活性的平衡
    • 增量构建机制: 通过 .quartz-cache 目录缓存 AST 和构建结果,增量更新受影响节点
    • 热重载：WebSocket 监听器实现的热重载，npx quartz build --serve 执行后,页面实时刷新。
    • 多线程处理：对于大量 md 文件的渲染，Quartz 会根据动态生成渲染的 worker 线程，提高处理速度。

学习曲线

  • 置复杂度评级：⭐️ ( 有 git,node 环境,1 分钟就能跑起来 )
  • quartz 官方文档非常完备
  • 兼容 Roam,Hugo,Obsidian,Mermaid 等 markdown 语法
  • 有 docker 环境支持

实战指南

安装说明

# 下载或者fork
git clone https://github.com/jackyzha0/quartz.git
cd quartz
 
# 注意: node 版本需要大于 19,可以使用 nvm 安装最新的 node 版本即可
nvm use v22.14.0
npm i
npx quartz create
 
# 修改jzhao.xyz为自己的github项目
# 在content目录添加index.md作为主页
# 在content目录添加其他md
 
# 本地调试
npx quartz build --serve
 
# 提交到git仓库后,会自动deploy
npx quartz sync

github page 自动部署

参考 github page官方文档 配置, 或者 quartz 官方文档 hosting-github pages

也可以参考我的 极客工具 项目 https://github.com/xtoolism/xtool , 生成的 github page 为 https://xtoolism.github.io/xtool

极客工具 XTool 公众号的文章都是在 obsidian 本地写好，然后执行 git commit-and-sync，github action 会自动执行博客的部署更新

深度评测

💎【知识管理范式革命】 传统笔记是信息坟墓，而 Quartz+Obsidian 是认知跃迁的火箭！实测对比三大差异：

| 工具维度 | 印象笔记/有道云笔记/Notion 🗃️ | Obsidian+Quartz 🧠 | | -------- | --------------------- | ------------------ | | 信息结构 | 线性文件夹 | 网状知识图谱 | | 知识复用 | 手动搜索 | 双向链接 自动关联 | | 价值延伸 | 远程存储 | 本地文件 AI 对话 | | 知识共享 | 手动发布 | 一键发布 |

⚡ 【有知识图谱的人，AI 才不是 Siri】 小白使唤 AI： 「帮我写篇经济课作业」→ 得到 ChatGPT 牌维基百科 你的知识库使唤 AI： 「结合我上周链的《泡沫经济史》+《龙虾社交学》→ 生成一份《2023 奶茶店暴雷预警报告》，梗用库里的蜜雪冰城段子」 （看见没？你喂给 AI 的关联越毒，它吐的答案越骚）

跑题了，Obsidian 大法好，AI 也香，最后用 Quartz 发布给大伙儿都知道就更美了。

关系图谱