Obsidian + MkDocs Knowledge Management¶
概念概覽
問題：Obsidian 與 MkDocs 的差異¶
核心知識¶
問題：Obsidian 與 MkDocs 的差異¶
| 功能 | Obsidian | 原生 MkDocs |
|---|---|---|
| 雙向連結 | 原生支援 | 不支援 |
| [[Wikilink]] | 原生支援 | 不支援 |
| 知識圖譜視覺化 | 原生支援 | 需插件 |
| GitHub Pages 部署 | 需額外工具 | 原生支援 |
整合策略（不拋棄現有 MkDocs）¶
- 語法兼容：mkdocs-roamlinks-plugin 讓 MkDocs 讀懂
[[Wikilink]] - 雙向連結：backlink_pass.py 在 build 前注入反向索引
- 不需要 Obsidian CLI：直接在 MkDocs 層面實現 Obsidian 的核心功能
Claude Code + Obsidian 社群方案調研結果¶
社群常見方案是用 Claude Code 的 wiki_manager 風格腳本自動維護 .md 文件，再用 Obsidian 作為本地瀏覽/編輯器，MkDocs 作為發佈端——三者分工明確。
經驗教訓¶
-
不需要 Obsidian CLI 也能在 MkDocs 實現 Obsidian 核心的雙向連結體驗
-
roamlinks + backlink_pass 的組合是最低侵入性的升級路徑，不需要重寫現有文件
常見陷阱¶
-
Obsidian 的圖譜視覺化是其最大優勢，MkDocs 目前無法完全複製，需接受這個限制
-
若未來想遷移回純 Obsidian vault，[[Wikilink]] 語法兼容，但 backlink section 會有冗餘內容需清理
相關概念¶
相關視角¶
以下頁面與本概念共享主題，但從不同角度切入。保留獨立視角同時提供交叉參考：
- Obsidian Backlink + MkDocs Roamlinks — 共享：
knowledge-management,mkdocs,obsidian/ 獨特：backlink,documentation - MkDocs Roamlinks + Backlink Pass — 共享：
knowledge-management,mkdocs,obsidian/ 獨特：backlink,wiki - Obsidian + Claude Code 知識庫整合 — 共享：
knowledge-management,obsidian,wikilink/ 獨特：backlinks,pkm - MkDocs Knowledge Graph Enhancement — 共享：
mkdocs,wikilink/ 獨特：backlinks,knowledge-graph - MkDocs Knowledge Wiki Enhancement — 共享：
knowledge-management,mkdocs/ 獨特：backlinks,roamlinks
來源 Sessions¶
| 日期 | Session | 貢獻摘要 |
|---|---|---|
| 2026-04-11 | a0379709-073f-4231-a61f-87b8486559f7 | 此 session 調研了 Obsidian 與 Claude Code + MkDocs 的整合方案，確立了以 mkdocs-roamlinks 橋接 Obsidian [[Wikilink]] 語法、以 backlink_pass.py 補足雙向連結能力的組合策略。 |