Obsidian + Claude Code 知識庫整合¶
概念概覽
Obsidian 的核心優勢（相對於純 MkDocs）¶
核心知識¶
Obsidian 的核心優勢（相對於純 MkDocs）¶
- 原生雙向連結：
[](<#>)Wikilink 自動建立反向索引，Graph View 可視化 - Dataview plugin：以 SQL-like 語法查詢 frontmatter metadata，實現動態知識聚合
- Canvas：白板式知識地圖，適合規劃複雜系統架構
社群常見 Claude Code + Obsidian 方案¶
- Claude 作為 Vault 寫入者：Claude Code 透過 Bash 直接寫
.md到 Obsidian Vault 目錄，利用 Obsidian 的 Graph View 做視覺化——適合本專案 - obsidian-ai-research-assistant plugin：在 Obsidian 內呼叫 Claude API，進行概念擴展和自動 tagging
- Vault 作為 Claude 的 context source：透過
@file或 MCP server 把 Vault 內容注入 Claude 對話
本專案的適配策略¶
因為已有 MkDocs + GitHub Pages 管線，不需要完整遷移到 Obsidian：
- 將 docs/concepts/ 同時作為 Obsidian Vault（兩者都是純 Markdown）
- Obsidian 負責本地瀏覽與 Graph View；MkDocs 負責發布
- wiki_manager.py 產生的 frontmatter 與 Obsidian Dataview 兼容（tags、related_concepts 欄位）
限制¶
- Obsidian CLI（
obsidian-cli）功能有限，主要用於開啟 Vault，無法做批次操作 - 真正的批次操作需直接操作文件系統，Obsidian 只負責視覺化
經驗教訓¶
-
MkDocs 與 Obsidian 並不互斥——同一個 Markdown 目錄可以同時被兩者使用
-
Obsidian Dataview 的 frontmatter 格式和 MkDocs 的 meta plugin 格式幾乎相容，設計 frontmatter 時可兩者兼顧
-
優先考慮低侵入性整合（讓 Obsidian 讀現有文件），而非遷移整個管線
常見陷阱¶
-
obsidian-cli 只是啟動器，不能作為 headless 工具在 CI 中使用
-
Obsidian 的 Graph View 在文件數 >200 時性能明顯下降，需配合 folder filter 使用
-
若 Wikilink 路徑與 MkDocs 路由不一致，需要 roamlinks plugin 做路徑解析橋接
相關概念¶
- Backlink System（雙向連結）
- Claude Code Channels vs Orchestration Layer
- MkDocs Knowledge Graph Enhancement
- MkDocs Knowledge Wiki Enhancement
相關視角¶
以下頁面與本概念共享主題，但從不同角度切入。保留獨立視角同時提供交叉參考：
- Obsidian + MkDocs Knowledge Management — 共享：
knowledge-management,obsidian,wikilink/ 獨特：github-pages,mkdocs - Obsidian Backlink + MkDocs Roamlinks — 共享：
knowledge-management,obsidian,wikilink/ 獨特：backlink,documentation - MkDocs Roamlinks Plugin — 共享：
knowledge-management,wikilink/ 獨特：documentation,mkdocs - MkDocs Roamlinks + Backlink Pass — 共享：
knowledge-management,obsidian/ 獨特：backlink,mkdocs
來源 Sessions¶
| 日期 | Session | 貢獻摘要 |
|---|---|---|
| 2026-04-11 | a0379709-073f-4231-a61f-87b8486559f7 | 調研 Obsidian CLI 與 Claude Code 搭配方案，識別社群常見模式與本專案可採納的設計 |