从 Obsidian 到公开站点：双链转换、发布链路与链接有效性 —— 横纵综合报告 未开始

题记与说明

课题：从 Obsidian 到公开站点：双链转换、发布链路与链接有效性（补充视角：个人 Wiki 自动化发布）
文档性质：横纵综合报告（最终稿；由初稿按独立审读意见逐条修订而成，修订要点见文末修订说明）
成文日期：2026-11-06；横轴数据截面：2026-11-05；修订复核日期：2026-11-06
输入章节：纵轴章节 output/reports/parts/2026-11-05-Obsidian双链转换与发布链路-vertical.md（历时叙事）；横轴章节 output/reports/parts/2026-11-05-从Obsidian到公开站点-个人Wiki自动化发布横向对比-horizontal.md（截面对比）
取证声明：两份章节的主干事实均在各自写作会话内通过 WebSearch / WebFetch 核实并随文附来源 URL——横轴章节含 11 次网络搜索、10 次网页直读、GitHub 仓库 REST API 实时元数据抓取（章节自述"7 个仓库"，与其健康度表实际列出的 8 行不一致，本次修订已对 8 仓逐仓重抓复核并统一为 8 仓口径，见 §2.3 表注）；纵轴章节对少量"史前"年份条目（1995 年 Wiki 诞生、2004 年 Markdown、Jekyll/Hugo/Eleventy 大致年份）以〔既有知识〕标注，仅作时间锚点、不作关键论据。最终稿修订（2026-11-06）新增的核实均随文标注"修订复核"：8 仓健康度数据重抓、Zensical 仓库与官网状态、super.so/pricing 直读、Obsidian 官方 Help（链接解析规则）、Vault 内预检插件与 Netlify 链接检查插件存在性、eclipse-edc 样例工作流 cron 频率、Roam 上线时间来源；其余内容只做结构整合、口径统一与交叉分析。两章节遗留的不确定点在 §3.4 如实保留（并区分"已消解/仍未决"），横轴章节提及的同日另一实例报告（#0）不在本综合范围内。

TL;DR

2020 年 Obsidian 把 [[双链]]、反向链接与图谱搬进本地 Markdown 文件夹，"把网状笔记变成公开站点"的需求几乎同时出现。到 2026-11 截面，课题三条线索——双链转换、发布链路、链接有效性——已收敛为普通用户可复制的范式：Vault + Git + GitHub Actions（构建 → lychee 巡检 → 自动建 issue）→ GitHub Pages / Cloudflare Pages。横向对比显示：官方 Obsidian Publish（$8/站/月起）定义付费省心上限，但不提供链接质量门禁；Quartz 5（⭐13,534）是开源体验上限，原生消化 wikilink、反链与图谱；Digital Garden 是选择性免费发布的均衡点；通用 SSG 都要付"适配层税"，且 MkDocs Material 已宣布 2027-05-05 EOL（距数据截面仅约 6 个月），新项目应转向其继任者 Zensical（修订复核：⭐6,092、迭代活跃，但官方仍处 Beta 过渡，见 §2.8 与 §3.4）。没有任何方案出厂自带死链门禁——链接有效性沉给了 lychee 为首的独立工具链。推荐默认组合：Quartz 5 + Pages 托管 + lychee CI 门禁，成本≈0；不愿碰 Git 者选 Digital Garden，付费免维护者选 Publish。课题已从"能不能发布"进入"多省心发布"阶段。

一、纵轴：发展脉络——从三条河流到一条流水线（1995–2026）

这个课题的"诞生点"在 2020 年，但它承接的三条河流各自更老。本章按时间推进，讲清三条线索——双链转换（Obsidian 私有语法与标准 Markdown/Web 之间的鸿沟）、发布链路（从官方付费托管到自建 SSG + CI/CD）、链接有效性（wikilink 解析歧义与死链巡检）——如何从各自为政汇聚成一条没人值守的流水线。

1.1 史前源流（1995–2019）：三条河流的汇聚

第一河：Wiki 与双链。 1995 年 Ward Cunningham 发明 WikiWikiWeb，[[页面名]] 式的 wiki 链接、反向链接和"人人可编辑的公开站"从第一天起就是一体的〔既有知识〕。此后二十多年，wiki 链接始终停留在"公开协作站"语境里，个人笔记工具长期缺席——直到 2019 年 Roam Research 以 beta 上线（上线时间有源可查：The Hustle 创业史追述其 "launched only last fall"，即 2019 年秋推出；"以 beta 起步"为〔既有知识〕，修订复核 2026-11-06），把双向链接、反向链接和每日笔记做成一种"思考工具"，并在 2020 年引爆了整个 "tools for thought" 浪潮；Obsidian 和开源的 Logseq 都是在这波浪潮中把双链"搬回个人本地文件"的代表（对比可见 Fabric 的 Obsidian vs Roam、The Sweet Setup 2022 对比、MPU 论坛 2020 年 11 月的开源替代讨论）。

第二河：Markdown 与静态站点生成器。 2004 年 Markdown 诞生，2008 年 Jekyll 与 GitHub Pages 把"仓库里的文本自动变成网站"变成免费现实，2013 年 Hugo、2017–2018 年 Eleventy 相继出现〔既有知识〕。静态站点的约定是：标准 Markdown + YAML frontmatter + 相对链接，这与后来 Obsidian vault 的组织方式天然接近，但语法并不相同——这道语法裂缝就是后来"双链转换"问题的源头。

第三河：自动化托管与 CI。 Netlify（2014 年创立）把"git push 即部署"做成了产品，2020 年 8 月宣布百万开发者（官方里程碑）；GitHub Actions 于 2019 年 11 月 GA 并对公共仓库免费；Cloudflare Pages 于 2020 年 12 月开 beta、2021 年 4 月 12 日 GA，主打免费不限带宽。这三层基础设施在 2019–2021 年就位，是后来"个人 Wiki 自动化发布"得以成立的物质前提。

驱动因素：云笔记（Evernote/Notion）的封闭性与 2020 疫情期的知识管理热，让"本地优先 + 纯文本 + 双链"成为明确的需求方向；而免费的静态托管与 CI 把"自己搭站"的边际成本压到接近零。

1.2 2020：诞生——双链装进本地文件夹，官方给出第一个发布答案

• 2020 年 3 月 30 日，Obsidian 第一个 beta 发布；4 月初公开亮相（创始团队在 Reddit 发布"future-proof Markdown note-taking app"）。创始人是曾做过大纲工具 Dynalist 的 Shida Li 与 Erica Xu，产品哲学是本地优先、纯 Markdown、把笔记间链接当作一等公民（Wikipedia)、Obsidian 官方 About、Ness Labs 创始人访谈、Taskade 里程碑梳理）。
• 2020 年 10 月（0.9.7 时代），插件 API 进入 alpha（论坛 Alpha 插件清单、dalao.ai 时间线）。同年推出两款付费订阅：Obsidian Sync 管同步，Obsidian Publish 就是"官方托管发布"——把 vault 里选中的笔记连同链接关系一键发到 publish.obsidian.md，带反向链接面板和局部图谱（Obsidian Help；早期鸟价持续到 2021 年 9 月 30 日，现行定价见 §2.7 与口径说明 §3.1，社区长期嫌贵，如这篇批评）。
• 2020 年 10 月，社区插件 obsidian-git 出现（原作者 denolehov，论坛发布帖；后由 Vinzent03 接手维护至今，Vinzent03/obsidian-git）。它把 vault 变成 git 仓库、支持定时自动 commit-push，成为日后一切"自动化发布"的第一环。
• 同年，链接检查器 lychee 由 Matthias Endler 用 Rust 写出第一版（作者 2026 年回顾）——当时它与 Obsidian 毫无关系，六年后却成为本课题闭环里的标配件。这个"无关的出身"是理解 §3.2 洞察三（链接有效性为何被结构性回避）的关键伏笔。

本阶段形态：官方 Publish 是"半自动"答案——发布动作仍由人触发、语法由官方全权处理、域名与样式受限、按月付费。双链转换问题被官方内部消化，但对想要免费、可定制、数据自主的用户来说，路还没有铺出来。

1.3 2021–2022：自建发布浪潮——Digital Garden、Quartz v3 与"git push 即发布"

• 2021 年，oleeskild 发布 Digital Garden 插件（oleeskild/obsidian-digital-garden）：在笔记 frontmatter 里加 dg-publish: true 即可把单篇笔记发布到 GitHub + Netlify 组合的免费站点，支持"选择性公开、私有笔记不出库"。这是第一个把"发布粒度控制在单篇笔记"的工具，2023 年还有论坛热门教程巩固了这套组合拳的地位（另一篇结构相近的教程见 §2.5 引 68562 帖）。
• Quartz v1–v3（Jacky Zhao）：面向"数字花园"的 Hugo 主题/模板，其关键零件是 hugo-obsidian（jackyzha0/hugo-obsidian）——一个 GitHub Action 与二进制，负责扫描 vault、把 [[wikilink]] 与嵌入关系解析成 JSON 供 Hugo 消费。这正是"双链转换"从应用内走向构建管线的标志（实践文章见 jacobian.org、sagar.se）。此后社区还涌现 obsidian-export、各类 Hugo/Eleventy/MkDocs 导出插件（如 Hugo Exporter 插件）。
• 托管侧：Cloudflare Pages 于 2021 年 4 月 12 日 GA（免费不限带宽），与 GitHub Pages、Netlify、Vercel 一起构成"零成本托管菜单"。
• 2022 年 10 月 13 日，Obsidian 1.0 正式发布（全新默认主题、标签页、主题商店改版，官方 changelog、1.0 发布页）；12 月 5 日 1.1.0 内测引入 Canvas 无限画布（changelog，12 月 20 日转正，MPU 讨论）。核心应用成熟 + 插件生态繁荣，使"vault 就是个人 Wiki 的源码"成为社区共识。

驱动因素：Publish 的价格与封闭性把用户推向自建；Netlify/Cloudflare 的免费额度与 Deploy-to-Netlify 按钮把搭建门槛降到一个插件配置；"digital garden"（数字花园）文化提供了叙事模板——笔记不必"完稿"才能公开，公开本身就是思考方式。

1.4 2023：双链转换工程化、Quartz 4 重写与链接检查进入 CI

• 双链转换的核心矛盾在这一年变得可讨论：Obsidian 默认 [[wikilink]] 是非标准语法，链接解析遵循"最短唯一路径 + 别名 + 未解析链接自动视为新笔记"等私有规则（修订复核 2026-11-06：三项已对照官方 Help 核实——"最短唯一路径"对应设置项 New link format 的 "Shortest path when possible — Uses the shortest unique path to the linked file"（Settings）；"别名"对应 wikilink 竖线语法 [[Example|Custom name]] 与 Aliases（Internal links）；"未解析链接自动视为新笔记"对应原文 "If the link points to a note that doesn't exist yet, Obsidian creates the note at that folder path"（同前引））；一旦离开 Obsidian，就要面对"转换为标准 Markdown 链接还是保留 wikilink""死链在构建期如何暴露"等问题。2026 年的实践文章（The Obsidian-Hugo Workflow, 2026-03-05）仍建议"在 Obsidian 里关掉 wikilink、改用标准 Markdown 链接"，Hugo 论坛的 wikilink 实验帖也说明主流 SSG 至今没有原生方案——转换层始终是发布链路里最"脏"的一环（该"建议关 wikilink"的立场与 Quartz 类专用 SSG"原生支持"并不矛盾，统一解释见 §3.1）。
• 2023 年 7–8 月，Obsidian 1.4 引入 Properties（1.4.0 内测 2023-07-26，1.4.5 公测 2023-08-31）：frontmatter 从"手写 YAML"升级为带类型与自动补全的结构化属性。发布管线从此可以稳定依赖元数据（dg-publish、permalink、draft、publishDate 等约定），为后续自动化铺平了路。
• 2023 年 8 月 20 日，Quartz 4 发布：完全抛弃 Hugo，用 TypeScript 从零重写（GitHub、发布公告、Reddit 帖），原生处理 wikilink、反向链接、图谱与全文检索，可在 GitHub Pages / Cloudflare Pages / Vercel 免费部署，被直接称作"免费版 Obsidian Publish"。hugo-obsidian 自此进入维护尾声（仓库最后更新 2024 年 3 月），"转换层内置进 SSG"成为趋势。
• 链接有效性进入 CI：官方 lycheeverse/lychee-action 定型了沿用至今的模式——提交时对新增内容失败构建、定时（cron）全站巡检、巡检结果落成 Markdown 报告并自动开 issue（官方 issue #134 讨论该模式，实践示例、真实 cron 工作流样例）。个人 Wiki 的"链接腐烂"问题第一次有了廉价、自动的防线。

驱动因素：Properties 让元数据可编程；Quartz 4 证明了"Obsidian 兼容层可以内置于构建器"；GitHub Actions 免费额度 + lychee 这类快速 CLI，让"每次 push 都检查一遍全站链接"从奢侈品变成默认项。

1.5 2024–2026：收敛——Bases 数据化、Quartz 5 与全自动个人 Wiki 范式

• Obsidian 持续演进：2025 年 5 月 21 日 1.9.0 内测推出核心插件 Bases（笔记集合变成可筛选/可公式的数据库视图，changelog），2025 年 8 月 18 日随 1.9.10 向全量用户转正（中文社区反应见知乎、中文论坛）；2026 年 10 月 5 日 1.14 公测带来 Bases 看板视图、MathJax 4.1.3、Electron 43，10 月 22 日 1.14.5 处理 Electron 安全更新（官方 changelog）。vault 的"数据化"让发布侧多出一类需要处理的内容形态。
• Quartz 5（© 2026）：官方文档站已更名 "Welcome to Quartz 5"（quartz.jzhao.xyz，文档页时间戳 2026-09-20），What's New 列出插件生态、YAML 配置、改进的 Obsidian 兼容性、页面类型系统与 BasesPage 插件——连 Obsidian 2025 年的 Bases 都已进入发布侧的兼容目标。六年前的"手工转换脚本"如今是 SSG 内置能力。
• lychee 的五年长跑与 2026 现状：作者 Matthias Endler 在《Five Years of Trying to Add Recursion to lychee》中回顾：lychee 始于 2020 年，如今约 4 万个 GitHub 仓库在用（含 Google、AWS、Microsoft、Cloudflare 的文档站；星数口径见 §2.3）；"站内递归爬取"这一最古老需求（issue #78，2020-12-14）历经四代实现失败，直到 2025 年 12 月的按域限速（PR #1929）、2026 年 2 月的 WaitGroup 原语（PR #2046）与 sitemap 支持（PR #2062）、3 月的统一请求层（PR #2100）才铺平道路，v1.0 仍以递归为门槛。这恰是"链接有效性"作为工程问题复杂度的缩影：全站巡检听起来简单，终止条件、限速与去重却需要五年打磨。
• 当下（2026）的个人 Wiki 全自动发布范式已经稳定：Obsidian（写）→ obsidian-git 或 Working Copy 自动 commit-push（Vinzent03/obsidian-git）→ GitHub Actions 运行 Quartz/Hugo 构建并部署到 GitHub Pages / Cloudflare Pages / Netlify → 每周 cron 跑 lychee 全站死链巡检（"每周"频率取自 §1.4 所引 eclipse-edc 样例工作流的 cron 表达式 0 0 * * 0，即每周日零点，修订复核 2026-11-06；非生态统一标准），失败自动开 issue（lychee-action、模式讨论）。不想自建的用户仍有 Obsidian Publish（价格争议延续，Pubsidian 等免费替代层出不穷）。

驱动因素：三股力量推动收敛——(1) 经济：免费 CI/托管让自建边际成本≈0，Publish 相对性价比逐年走低；(2) 技术：wikilink 解析从"每人一套脚本"沉淀为 SSG 内置层；(3) 质量文化：链接腐烂是公开 Wiki 的头号体验杀手，"构建失败 + 定时巡检 + 自动开 issue"成为可复制的标准答案。

1.6 阶段速查表

1.7 纵轴小结：三个未完成态

六年里，"从 Obsidian 到公开站点"从一个人的手工活（官方 Publish 或手写脚本）变成一条没人值守的流水线。但纵轴在 2026 年留下三个未完成态，它们恰好是横轴对比里最值得较真的三处：其一，wikilink 与标准 Markdown 的语法张力仍未消解——2026 年的通用路线实践文章仍在建议"在 Obsidian 里关掉 wikilink"；其二，全站递归链接巡检直到 2026 年才在架构上闭环、v1.0 未至；其三，官方 Publish 与自建管线仍各占一方市场。课题没有终点，只是从"能不能"演进为"多省心"。

二、横轴：横向对比——2026-11-05 截面的格局

纵轴讲完"怎么走到今天"，本章在同一时间截面上把所有可选方案摆开对位。横轴章节数据为独立取证（11 次搜索 + 10 次直读/API 抓取，为横轴章节自述口径——其"7 个仓库 API 抓取"与下表 8 行的差异已由本次修订逐仓重抓复核消解，见 §2.3 表注），健康度数据为 2026-11-05 时点值。

2.1 课题拆解与五个阵营

把"个人 Wiki 自动化发布"这条链路拆成三个能力段：

1. 双链转换：Obsidian 的 [[wikilink]]、![[嵌入]]、反向链接、图谱不是标准 Markdown，任何"出站"方案都要回答"谁负责把它们翻译成 Web 世界的东西"；
2. 发布链路：改动笔记后，从"保存"到"公网可见"之间有多少人工环节？能否做到 git push 即发布、甚至保存即发布？
3. 链接有效性：公开站点上的死链（内部断链 + 外链失效）谁来发现、在什么时机发现（构建时 / 发布后巡检）、能否形成 CI 门禁？

2026-11-05 截面上，解法分为五个阵营：官方付费 SaaS（Obsidian Publish）、Obsidian 专用开源 SSG（Quartz）、插件型选择性发布（Digital Garden、Webpage Export）、通用 SSG + 适配层（Hugo、MkDocs/Zensical、Astro）、替代笔记应用自带发布（Logseq、思源、Foam、Notion+Super）。横切的还有一层链接检查工具链（lychee、markdown-link-check、htmltest）。

2.2 主对比表（2026-11-05 截面）

2.3 实时健康度快照（GitHub API 直读，2026-11-05）

（来源：横轴章节逐仓 api.github.com/repos/<owner>/<repo> 直读。星数随时间漂移，以抓取时点为准。修订复核（2026-11-06）：初稿所据横轴章节自述"7 个仓库 API 抓取"，但其表格实列 8 行，口径不一致；为消解矛盾，本次修订已对上表 8 个仓库逐一重新抓取 GitHub REST API——8 仓全部可达，除 foam 在数据截面之后又于 2026-11-05 16:35 UTC（修订时点前）有一次推送、其"最近推送"按截面口径仍记 2026-11-04 外，其余各仓的星数/Issue 数/最近推送/License/语言与上表逐项一致。故本稿统一按 8 仓 API 抓取口径表述。另注意区分两个口径：lychee 的 ⭐4,096 是 star 数，纵轴引用的"约 4 万个 GitHub 仓库在用"是使用量口径，两者不矛盾，见 §3.1。）

2.4 双链转换：谁能读懂 [[...]]

• Quartz 5 官方文档（quartz.jzhao.xyz，横轴章节直读首页）明列"开箱即用"特性：Obsidian compatibility、wikilinks, transclusions、Backlinks、graph view、full-text search、LaTeX、popover previews。它是本次对比的开源方案中唯一在 SSG 本体把 Obsidian 语法兼容列为一级特性并逐项落地的项目——下条 Digital Garden 的 backlinks/图谱/搜索由"插件 + 11ty 模板"组合承载，不属 SSG 本体的一级特性，两者表述并不矛盾。
• Obsidian Publish（obsidian.md/pricing 直读）以"Graph and full text search"为卖点，双链体验与本地端完全一致，因为渲染器就是 Obsidian 自己的。
• Digital Garden（GitHub 仓库与 docs，横轴章节取证）以 11ty 模板承载 backlinks/图谱/搜索，配合 dg-publish: true frontmatter 做选择性发布——插件经 GitHub API 把标记笔记提交到花园仓库（来源：oleeskild/obsidian-digital-garden、官方文档、论坛教程；GitHub Pages 路线见 discussion #389）。
• 通用 SSG 全部需要适配层：MkDocs 侧依赖 pymdown-extensions 的 MagicLink 与社区插件（mkdocs-obsidian-links、Obsidian 论坛的 wikilinks/backlinks/callouts 方案、MagicLink 文档）；Astro Starlight 原生不支持（引自横轴章节搜索到的社区共识，未直读官方 discussion 原帖，见 §3.4）。
• 独立转换层：zoni/obsidian-export（Rust CLI）把整个 vault 的 wikilink/嵌入解析为标准 CommonMark，作为 Pandoc 或任意 SSG 的前级——这是"转换能力外置"路线的代表性底座（来源：crates.io、作者论坛帖）。

小结：专用路线（Publish/Quartz/Digital Garden）把转换内化；通用路线把转换外置给插件、钩子或前级工具。选型的第一刀就切在这里：笔记越"Obsidian 味"（双链密度高、嵌入多），专用路线的边际优势越大——这正是纵轴 §1.4 所述"建议关掉 wikilink"的通用路线立场的另一面。

2.5 发布链路：从保存到公网可见有几道人工环节

按自动化程度排序：

1. 保存即发布：Obsidian Publish（应用内按钮）、Notion+Super（云端天然同步，Super 挂壳成站）。全自动、零 CI，代价是订阅费（见 §2.7）。
2. 插件推送 → 托管平台自动构建：Digital Garden（插件经 GitHub API 提交 → Netlify 免费 tier 自动构建，论坛教程）；这是"选择性公开 + 免费全自动"的最短路径（其链接检查门禁的落点与可行性论证见 §2.6）。
3. git push → CI 构建：Quartz 5 官方文档列出的部署目标为 GitHub Pages、Cloudflare、Netlify、Vercel（quartz.jzhao.xyz 直读），一次配置后改动即发布；Foam 走 foam-template 自带的 GitHub Pages Actions（发布文档）。
4. 本地导出 → 手动上传：Webpage Export 导出整站 HTML（仓库），自动化最弱，但其 ⭐1,375 说明"不想碰 Git"的真实需求存在；注意其最近推送停在 2026-03-19，维护节奏已放缓（横轴章节 API 实测）。
5. 替代应用路线：思源笔记无官方内置静态站点导出（官方 issue #34 讨论），依赖社区工具 OceanPress、syblog（思源+Hugo） 或导出 Markdown 自行部署（中文工作流见 少数派）；Logseq 在 2026 年处于大版本重写期，多篇 2026 年对比文提示新用户观望（nexasphere 2026-07），其发布依赖桌面导出 + 社区 Action，手动成分更高。

2.6 链接有效性：谁都不是"出厂自带"

这是本课题的差异化维度。2026-11-05 截面的实测结论：没有任何一条发布路线自带"发布后链接质量门禁"（口径限定：本断言不含"Quartz 构建期对死链的失败行为"——该行为未复核，见 §3.4.3，故本节只论证"门禁需外挂"，不对 Quartz 构建失败与否做断言）。

• lychee（lycheeverse/lychee，⭐4,096、Apache-2.0、推送 2026-11-02）是 Rust 异步链接检查器，覆盖 Markdown/HTML/reST/网站，配官方 lychee-action（GitHub Marketplace 上架）可做 PR 门禁，支持 .lycheeignore、独立退出码，并能配合 create-issue-from-file 自动开 issue（来源：实战教程、action.yml）。它检查的是源文件与站点 URL，可在发布前拦截断链；其全站递归爬取能力的工程演进见 §1.5。
• markdown-link-check（tcort/markdown-link-check，⭐724、ISC、推送 2026-10-22）：Node 系单文件检查，轻量易嵌 Actions，速度与并发弱于 lychee。
• htmltest（wjdp/htmltest，⭐378、MIT、推送 2025-01-20）：检查构建产物 HTML（含锚点），是 Hugo 系 CI 的常见终检工具，但维护节奏明显放缓（最近推送停在 2025-01-20）。
• 策略：最优实践是"Vault 内插件预检（源文件级）+ CI 侧 lychee/htmltest 终检（产物级）"双层防御。Vault 内预检有现成工具，修订点名（均为社区插件，修订复核 2026-11-06）：Broken Links（扫描全库未连接任何文件的内部链接，含标题/块级断链）、Link Integrity（持续检测断链与孤立文件，侧边栏复核）、Find orphaned files and broken links（与 obsidian-git 同作者 Vinzent03，⭐376、推送 2026-07-28）。门禁能否嵌进发布流水线，取决于"构建动作由谁跑"：自建 CI 的路线（Quartz/Hugo/MkDocs/Foam）构建跑在用户自己的 GitHub Actions 里，能把 lychee/htmltest 直接嵌进流水线；付费 SaaS（Publish/Super）的构建在厂商黑盒内、不暴露检查钩子，本地导出路线则根本没有构建流水线，这两类目前只能靠上述 Vault 内预检兜底。
• Digital Garden 的门禁落点（初稿缺失，修订补齐）：Digital Garden 同样走"插件提交 → Netlify 自动构建"（§2.5）。它不在"出厂可嵌门禁"清单里，但也不属于"只能靠 Vault 内预检"的那一类——因为花园仓库就是用户自己的 GitHub 仓库（插件经 GitHub API 提交笔记，且官方支持改走 GitHub Pages 路线），所以用户技术上可以自行挂上门禁：(a) 在花园仓库挂 GitHub Actions 跑 lychee，对源 Markdown 做源文件级检查（与 Quartz 路线同法）；(b) 在 Netlify 构建侧挂链接检查 build plugin，如 Munter/netlify-plugin-checklinks（修订复核：⭐88、推送 2023-03，维护放缓）。但两条路均非 Digital Garden 官方文档或主流教程覆盖、需用户自己动手，且构建产物中 wikilink 转换结果的检查覆盖面未做端到端验证，故本稿将其归为"能挂门禁但要自建"的中间档，而非"出厂可嵌"。

2.7 成本（个人单站口径）

• Obsidian Publish：$8/站/月（年付 $96）或 $10/站/月（月付 $120），按站计费（obsidian.md/pricing，横轴章节直读原文："publishing notes to the web… No technical knowledge required… Graph and full text search"）。5 年显性成本 $480–600。与纵轴"年付约 $96–120/年"口径一致；社区批评文标题中的 "$198/年" 为另一口径，见 §3.1。
• Super（Notion 挂壳）：初稿据搜索摘要写为"按 $5/成员/月（年付 $50）报价"，换算自相矛盾（$5×12=$60≠$50）；修订时已直读 super.so/pricing 原文（2026-11-06）修正——矛盾源于把 Teams 团队版的两档计费周期误写为同一档：该页实际报价为月付 $5/成员，或年付 $50/成员（折合约 $4.17/月）；对"个人单站口径"更相关的是 Personal 个人站 $16/站/月（年付 $144/站，折合约 $12/月），另有免费档（$0）与 Pro $28/月；分析功能确为另收（Analytic 附加包 $10/月起、按页面浏览量分档）。已并入 Notion 底座套餐的说明不变，详见 §3.4.1。
• 开源路线：Quartz/Digital Garden/Hugo/MkDocs/Foam 均 MIT 等宽松许可、零许可费；托管走 GitHub Pages/Cloudflare/Netlify/Vercel 免费层（Quartz 官方文档确认四个托管目标）。显性成本趋近于零，隐性成本是 Git/CI 操作能力与首次配置时间。
• 对比结论：Publish 的费用本质是"把 CI、域名、图谱渲染、搜索全部外包"的税；免费路线把这笔税转嫁给用户的动手时间。Digital Garden 是"免费 + 近乎全自动"的均衡点。

2.8 生态成熟度：2026 是集中换代之年

• Quartz 是社区事实标准：⭐13,534、推送 2026-11-01，且已完成 5.0 大版本迭代（官方站点现以 Quartz 5 为门面，社区教程持续跟进，Reddit 早年即以"免费 Publish 替代"定位走红：讨论帖）。
• MkDocs Material 的重要时效性警告（横轴章节直读官网横幅原文）："End of life on May 5, 2027"，"Critical maintenance continues through May 5, 2027, while our team develops Zensical, its compatible successor"（squidfunk.github.io/mkdocs-material）。仓库本身依旧极活跃（⭐27,600、开放 Issue 仅 1），但新启动的个人 Wiki 不应再选 Material，应转向其继任者 Zensical；存量用户迁移窗口剩约 6 个月（起算点为横轴数据截面 2026-11-05，距 EOL 2027-05-05；初稿误写为"约 18 个月"，系起算点错误，修订更正）。
• Zensical 自身的健康度（初稿缺失，修订补齐）：zensical/zensical（修订复核 2026-11-06，GitHub API 直读：⭐6,092、开放 Issue 0、推送 2026-11-05、Rust、MIT，2025-05 建仓，自述 "A modern static site generator by the Material for MkDocs team"）——由 Material 团队开发、迭代活跃；但 zensical.org 显示其产品文档处于 "Beta transition" 阶段，未见生产就绪声明，与 Material 的功能对齐程度亦未核验（见 §3.4.8）。因此推荐口径为：新项目可转向 Zensical，但需接受早期产品风险；求稳者可留 Material 至 2027-05 EOL 再迁移。
• Webpage Export：推送停在 2026-03-19、开放 Issue 235——能力独特但维护存疑，选它要有"随时自己接管"的预期。
• Digital Garden：2,527 星、持续推送（2026-10-29），生态成熟；开放 Issue 214 偏多，反映"模板 + 插件 + Netlify"三层结构的排障复杂度。
• Foam：⭐17,472、推送 2026-11-04——如果用户的工作台本来就是 VSCode，Foam 是"编辑器与发布工具同一"的最小栈。
• Logseq：2026 年重写期，多源提示"暂不推荐新用户"，发布链更手动。

横轴小结（能量守恒与空位）：双链转换、自动化、链接门禁三项能力在所有方案中呈"跷跷板"分布——Publish 买走前两项的便利却给不了第三项；免费 CI 路线三项全可达成，但初始配置最重。课题的最优解（Quartz + lychee 双层门禁）恰好落在"全免费但全自建"象限。链接有效性是被所有主流方案回避的职责：它既不性感也不变现，于是沉给了独立工具链（lychee 4,096 星 > markdown-link-check 724 > htmltest 378，且 lychee 是唯一 2026-11 仍高频推送的——横轴章节 API 实测）。这预示"发布链 × 质量门禁"仍是生态空位。成熟度断层（Material 宣布 EOL、Logseq 重写悬置、Webpage Export 放缓）则说明 2026 年是"文档/Wiki 发布栈"集中换代的年份；Quartz 5 与 Zensical 是两个换代后的新锚点（后者的独立数据与本稿推荐口径见上）。

三、交叉洞察：两轴合起来说明了什么

3.1 口径统一：两章节表述差异的消解

综合两章时发现四处表述差异，均可解释，非事实矛盾，在此统一口径：

1. Obsidian Publish 价格的三种说法。横轴主表 "$8/站/月（年付）或 $10/站/月（月付）" 与纵轴 "年付约 $96–120/年，按计费周期不同有差异" 是同一事实的两种粒度（$8×12=$96，$10×12=$120），本稿统一采用"年付 $96（$8/月）、月付 $120（$10/月）"。纵轴所引批评文标题中的 $198 与现行定价不同，应系历史价格或计费方案差异，初稿保留来源、不做断言。
2. "建议关掉 wikilink" vs "Quartz 原生支持 wikilink"。纵轴引 2026 年实践文章建议在 Obsidian 里关掉 wikilink，横轴强调 Quartz 5 原生支持——两者说的是不同路线：前者针对通用 SSG（Hugo/Astro/MkDocs）的适配层场景，源头改标准链接可省掉适配税；后者是专用 SSG 把转换内化后的能力。统一结论见 §3.3 决策第一刀。
3. lychee 的"4 万仓库" vs "⭐4,096"。前者（纵轴引作者回顾）是"有多少仓库在用"的使用量口径，后者（横轴 API 实测）是 star 数，两个指标量纲不同、互不冲突。本稿在涉及热度对比时统一用 star 口径，涉及采用广度时用使用量口径。
4. Quartz 版本基准。纵轴叙事按"Quartz 4（2023-08-20）→ Quartz 5（© 2026）"推进，横轴主表已按 Quartz 5 现状（⭐13,534、推送 2026-11-01）计。两章实为同一条时间线的不同切片，本稿统一以 Quartz 5 为当前基准、Quartz 4 为历史节点。

另消解一处重复：两章节都讲了 Digital Garden 论坛教程、Quartz 崛起与 lychee-action 模式，本稿按"时间叙事归纵轴、截面对比归横轴"各归其位，交叉含义收入本章。

3.2 五条交叉洞察

洞察一：六年问题重心迁移曲线——"能不能 → 免不免费 → 可不可靠 → 省不省心"。 纵轴显示问题经历四次跃迁：2020 年"能不能把双链笔记发出去"（官方 Publish 垄断答案）；2021–2022 年"能不能免费地发"（自建浪潮）；2023 年"能不能可靠地发"（CI 门禁定型）；2024–2026 年"能不能省心地发"（范式收敛）。横轴恰好在第四阶段的平面上展开竞争：Publish 卖省心，Quartz 卖免费省心，Digital Garden 卖选择性省心，lychee 补质量。两轴互相印证——市场已把前三问解决掉，当下竞争的全部焦点落在"省心程度 × 链接质量"这个新平面。

洞察二：转换层的三次搬家，决定了横轴的阵营分野。 双链转换能力沿纵轴搬了三次家：第一次在应用内（2020 Publish，官方全权处理但封闭）；第二次在独立构建管线零件里（2021 hugo-obsidian、obsidian-export，人人可改但人人要装）；第三次内置进 SSG（2023 Quartz 4、2026 Quartz 5 连 Bases 都兼容）。横轴"专用 vs 通用"的第一刀，正是这三次搬家的沉积结果：专用路线站在第三次搬家的终点，通用路线（Hugo/Astro/MkDocs）仍停在第二次——所以 2026 年的通用路线教程还在建议"在源头关掉 wikilink"，所以通用路线都要付"适配层税"。纵轴解释了横轴格局的成因。

洞察三：链接有效性被回避，不是没人看见，而是真的难。 横轴实测"没有任何方案出厂自带发布后门禁"；纵轴补上成因链：链接检查工具自 2020 年起就是与笔记生态无关的独立谱系（lychee 诞生时与 Obsidian 毫无关系）；至于为何两头都不做——一种解释（动机推测，非两章节文本内证据）是：发布侧商业厂商（Publish/Super）缺少内置"给自己找麻烦"质检功能的动机，开源 SSG 维护者的精力也更优先花在观感对齐 Publish 上。两头不管的空位由 CI 工具链填补；而 lychee 自己五年攻坚"站内递归爬取"（四代实现失败、2025-12 至 2026-03 四个 PR 才铺平道路）的历史说明，这个空位不是机会窗口，而是硬工程。三方合力的结果：链接有效性成了唯一"钱买不来、厂不给、只能自己建"的能力。

洞察四：免费基础设施既是赋能者也是加速淘汰器。 纵轴的 2019–2021 免费托管/CI 三件套是整个课题成立的物质前提；横轴的成熟度断层（Material EOL、Logseq 重写、Webpage Export 放缓、htmltest 停更一年多）则是它的另一面——零成本生态里，维护者激励不足的项目死得更快，而用户迁移成本近乎零，于是 2026 年出现集中换代。被换代扫过的正是 2021–2022 那波的早期零件（hugo-obsidian 2024-03 停更、htmltest 2025-01 停更、Webpage Export 2026-03 放缓），新锚点（Quartz 5、Zensical）都把"承接存量"或"兼容 Obsidian"列为一级目标。对用户的推论：选发布链要看维护者叙事是否处在上升段，而不是只看星数。

洞察五：经济学上，Publish 的税在变贵，免费路线的时间成本在变便宜。 横轴定义 Publish 订阅费为"外包税"；纵轴显示这笔税的相对价格六年间持续走高——因为免费路线的能力上限在涨（Quartz 5 已覆盖到 Bases 兼容，观感差距收窄），而 Publish 的差异化基本盘没变。反向看，免费路线的隐性成本（Git/CI 学习 + 首次配置）随范式标准化而下降：2021 年还需要读 hugo-obsidian 源码拼管线，2026 年是 clone 模板 + 挂一个 lychee-action。两轴相交处的结论是：Publish 的可辩护场景正在收窄到"完全不想接触任何工程概念的人"，而这批人同时要接受"链接门禁也买不到"的代价。

3.3 对用户的判断与建议

决策第一刀：双链密度。 笔记重度使用 wikilink/嵌入/图谱（"Obsidian 味"浓）→ 选专用路线（Quartz 5 / Digital Garden / Publish），转换层已内化，不必自虐式地改写链接习惯；笔记偏长文、双链稀疏 → 通用 SSG 的适配层税可承受，且换来更强的主题与定制生态（但注意 Material EOL，见下）。

决策第二刀：愿不愿意花半天学 Git/CI。 愿意 → 走免费全自动路线，一次性投入换五年零订阅费（成本口径对齐 §2.7 的"5 年显性成本 $480–600"）；不愿意 → Digital Garden（只想"标记哪篇发哪篇"）或 Publish（想完全零维护）。

三个推荐组合（按场景）：

1. 零成本全自动（推荐默认）：Obsidian vault → Quartz 5 → GitHub Pages/Cloudflare Pages，CI 里挂 lychee-action 做断链门禁，每周 cron 全站巡检（频率取自 §1.4 所引样例工作流的 0 0 * * 0，即每周日）失败自动开 issue。双链/反链/图谱全保留，git push 即发布，成本≈0，适合愿意一次性花半天配置的用户。这就是纵轴 §1.5 收敛出的范式本身。
2. 选择性公开的极简路：vault → Digital Garden 插件（dg-publish: true 门控私域隔离）→ Netlify 免费层。适合不想学 Git 工作流、只想"标记哪篇发哪篇"的用户；接受三层结构（模板 + 插件 + Netlify）的排障复杂度。
3. 付费省心路：Obsidian Publish（$8/月年付）。零 CI、零维护，但接受订阅费与供应商锁定，且链接门禁仍需 Vault 内插件自查——钱买不来本课题关心的"链接有效性保障"，这是两轴共同确认的最重要提醒。
4. （边缘情形）已在 Notion 的人：Notion+Super 保存即发布，但没有双链转换问题可言——它根本不是 wikilink 范式，属于换生态而非换发布链。

风险与时机提示（横轴 2026 换代潮的直接推论）：

• 新项目不要再选 MkDocs Material（2027-05-05 EOL），转向继任者 Zensical（活跃但官方仍处 Beta 过渡，取舍见 §2.8 与 §3.4.8）；存量 Material 用户迁移窗口约 6 个月（截面 2026-11-05 → EOL 2027-05-05）。
• Logseq 处于大版本重写期，新用户观望；Webpage Export 选它要有"随时自己接管"的预期。
• lychee 全站递归 v1.0 未至，配置全站巡检时参考已验证的工作流样例（eclipse-edc cron 工作流），并接受"提交拦截 + cron 巡检"的双时机模式。
• 无论选哪条路线，链接门禁都要自己挂：自建 CI 路线做"Vault 内预检 + CI 产物终检"双层防御；SaaS（Publish/Super）与本地导出路线至少做 Vault 内预检——可用 Broken Links、Link Integrity 或 Find orphaned files and broken links 等现成插件（见 §2.6）；Digital Garden 虽不在"出厂可嵌门禁"清单，仍可在自己的花园仓库/Netlify 上自行挂上门禁（可行性与理由见 §2.6）。

一条今天就能抄的范式清单（两轴合并的最终输出）：Obsidian 写作 → obsidian-git 自动 commit-push → GitHub Actions 构建 Quartz 5 → 部署 GitHub Pages/Cloudflare Pages → cron 跑 lychee，失败自动开 issue；Publish/Digital Garden 两条捷径各自成立，但都省不掉其中"链接检查"那一环（前者只能 Vault 内预检，后者可自行在花园仓库/Netlify 侧加挂，见 §2.6）。

3.4 遗留不确定点（如实保留；标注〔已消解〕者为修订时补验，2026-11-06）

1. Super 定价〔已消解〕：初稿"$5/成员/月（年付 $50）"来自横轴章节搜索摘要转述 super.so/pricing 且换算自相矛盾；修订时已直读该页原文修正（Teams 团队版月付 $5/成员、年付 $50/成员系两档计费周期；个人站 Personal 为 $16/站/月、年付 $144/站；Pro $28/月；分析附加包 $10/月起）。残余不确定点仅为页面价格随时间变动、历史口径（如批评文中其他报价）不再逐一追溯。
2. Astro Starlight 原生不支持 wikilinks：引自横轴章节搜索结果中的社区共识表述，未直读官方 discussion 原帖（正文 §2.2 表内该行已加脚注指回本条）。
3. Quartz 构建对死链的失败行为：相关 issue（#454）未被横轴章节独立复验，本稿因此仅表述为"链接门禁需外挂检查器"，不对 Quartz 构建失败行为做断言（正文 §2.6 总论断处已加口径限定指回本条）。
4. 各托管平台免费层配额（带宽/构建次数）：未核验具体数字，仅确认 Quartz 官方文档列出的四家托管目标存在。
5. GitHub 星数：均为 2026-11-05 抓取时点值，随时间漂移（修订时已对 §2.3 表内 8 仓重抓复核，结果见该表注；Zensical 为 2026-11-06 修订复核值）。
6. Publish 历史价格口径：批评文标题 $198/年 与现行 $96–120/年 的差异原因（历史定价/计费方案/捆绑）未核实。
7. 纵轴〔既有知识〕条目：1995 年 Wiki 诞生、2004 年 Markdown、Jekyll/Hugo/Eleventy 年份为模型既有知识标注，仅作时间锚点。Roam 上线时间已于修订时补来源（The Hustle，2019 年秋），其"以 beta 起步"仍属〔既有知识〕。
8. Zensical 成熟度（修订新增）：修订时已补其独立健康度数据（zensical/zensical：⭐6,092、推送 2026-11-05、Rust、MIT、2025-05 建仓）与官网 "Beta transition" 状态，但其生产就绪程度、与 Material 的功能对齐程度、长期维护承诺仍未核验——"新项目应转向 Zensical"的建议以此为限，直选者需自担早期产品风险。

四、参考来源

Obsidian 官方与版本节点

• Obsidian About / Changelog / 1.0 发布页 / Publish / Pricing / Help / Help: Internal links / Help: Settings（New link format） / Help: Aliases
• 1.0.0 (2022-10-13)、1.1.0 Canvas (2022-12-05)、1.4.0 Properties (2023-07-26)、1.4.5 (2023-08-31)、1.9.0 Bases (2025-05-21)、1.9.10 (2025-08-18)
• Wikipedia: Obsidian)、Ness Labs 访谈、dalao.ai Obsidian 时间线、Taskade 里程碑梳理

发布链路方案

• jackyzha0/quartz / Quartz 5 文档站 / What's New / Quartz 4 发布推文 / Reddit "免费 Publish 替代"帖
• oleeskild/obsidian-digital-garden / 官方文档 / 论坛教程 40717 / 论坛教程 68562 / discussion #389（GitHub Pages 路线） / Hamatti 教程
• KosmosisDire/obsidian-webpage-export
• Vinzent03/obsidian-git / obsidian-git 原发布帖 (2020-10)
• jackyzha0/hugo-obsidian / jacobian.org 实践 / sagar.se 实践 / Hugo Exporter 插件 / Hugo 论坛 wikilink 实验帖 / The Obsidian-Hugo Workflow (2026)
• zoni/obsidian-export / crates.io / 作者论坛帖
• 通用 SSG 适配层：squidfunk/mkdocs-material（EOL 2027-05-05 横幅）/mara-Li/mkdocs-obsidian-links / MkDocs 自托管方案帖 / MagicLink 文档 / zensical/zensical（修订复核） / zensical.org（修订复核）
• 替代应用路线：foambubble/foam-template / Foam 发布文档 / 思源 issue #34 / OceanPress / syblog / 少数派中文工作流 / nexasphere 2026 笔记应用对比 / super.so/pricing（修订时直读）

链接有效性工具链与 Vault 内预检

• endler.dev/2026/lychee-recursion（作者五年回顾） / lycheeverse/lychee / lycheeverse/lychee-action / action.yml / issue #134（门禁模式讨论） / rostand.dev 实战教程 / eclipse-edc cron 工作流样例（修订复核：cron 为 0 0 * * 0，每周日） / tcort/markdown-link-check / wjdp/htmltest
• Vault 内预检插件（修订复核 2026-11-06）：Broken Links / Link Integrity / Vinzent03/find-unlinked-files（Find orphaned files and broken links）
• 托管侧链接检查（修订复核 2026-11-06）：Munter/netlify-plugin-checklinks

基础设施与背景

• GitHub Actions GA (2019-11-11) / Cloudflare Pages GA (2021-04-12) / Netlify About / Netlify 百万开发者 (2020-08) / GitHub (Wikipedia)
• 背景与争议：Fabric: Obsidian vs Roam / The Sweet Setup 对比 / MPU 开源替代讨论 / MPU Canvas 讨论 / The Hustle: Roam Research 创业史（修订复核） / Alpha 插件清单 (0.9.7) / 早期鸟价帖 / Publish 价格批评 / Pubsidian 免费替代帖 / 知乎 Bases 反应 / 中文论坛 Bases 讨论

五、修订说明（初稿 → 最终稿）

本最终稿按独立审读意见逐条修订，未删减初稿正文，所有未被质疑的内容原样保留。八项意见的处置如下：

1. Material 迁移窗口算术：§2.8、§3.3 两处"约 18 个月"改为"约 6 个月"，并注明起算点（横轴数据截面 2026-11-05 → EOL 2027-05-05）。
2. Super 定价换算矛盾：§2.7 改为自洽表述——修订时直读 super.so/pricing，确认矛盾源于把 Teams 版两档计费周期（月付 $5/成员、年付 $50/成员）误写为同一档，并补记对个人口径更相关的 Personal 档（$16/站/月）；§3.4.1 标注〔已消解〕并保留价格随时间变动的残余提示。
3. 仓库计数 7 vs 8：修订时对 §2.3 表内 8 仓逐一重抓 GitHub REST API 复核（8 仓全部可达、数值与表一致，仅 foam 在截面后有一次推送漂移），取证声明、§2 章引言与 §2.3 表注统一为"8 仓 API 抓取"口径，并如实记录横轴章节自述 7 仓的不一致及消解方式。
4. Zensical 无自身数据：补齐独立健康度（zensical/zensical ⭐6,092、推送 2026-11-05、Rust、MIT、2025-05 建仓，GitHub API 修订复核）与官网 "Beta transition" 状态；§2.2 主表该行拆分 Material/Zensical 两列数据，TL;DR、§2.8、§3.3 的推荐措辞统一为"新项目应转向 Zensical（活跃但 Beta 过渡，自担早期风险）"，并把"生产就绪/功能对齐未核验"列入 §3.4.8。
5. 预检与门禁落点缺失：§2.6 点名 Vault 内预检插件（Broken Links、Link Integrity、Find orphaned files and broken links）并给出"门禁能否内嵌取决于构建动作由谁跑"的判据；新增 Digital Garden 门禁落点段（花园仓库为用户自有 GitHub 仓库，可自挂 GitHub Actions/lychee 或 Netlify build plugin netlify-plugin-checklinks，属"能挂但要自建"的中间档）；§2.5、§3.3 相应回填。
6. 不确定点回注正文：§2.6 总论断加口径限定（Quartz 构建死链行为未复核，见 §3.4.3）；§2.2 主表 Astro 行与 Notion+Super 行分别加脚注指向 §3.4.2/§3.4.1。
7. 核心前提补来源：§1.4 链接解析三规则逐项对照官方 Help（Internal links / Settings / Aliases）补来源；§1.1 Roam 上线时间补 The Hustle 来源，"以 beta 起步"标注〔既有知识〕。
8. 五处口径统一：(a) §3.3 "六年零订阅费"改为"五年"并对齐 §2.7 成本口径；(b) §1.7、§3.2 的"少用 wikilink"统一回原文"关掉 wikilink"；(c) §2.4 "唯一……开源 SSG"限定为"SSG 本体"，并说明与 Digital Garden 插件+模板组合不矛盾；(d) §3.2 洞察三的动机推断加"一种解释（动机推测，非文本内证据）"措辞；(e) "每周 cron"标注频率出处（所引样例工作流的 0 0 * * 0，修订复核）。

*本最终稿约 9,900 字（正文汉字口径，实测汉字 9,924 字，初稿为 7,763 字，无删减），综合自两份章节文件并经独立审读意见修订。横轴健康度数据截面为 2026-11-05，修订复核日期为 2026-11-06，引用时请注意时效。*