Obsidian 调研笔记

状态: 📦 已归档

创建日期: 2026-02-28
最后更新: 2026-02-28

---

什么是 Obsidian

本地优先的 Markdown 知识库编辑器。数据存储为纯 .md 文件，没有专有数据库。把一个文件夹指定为 "Vault" 直接读写 .md 文件。

• 跨平台：macOS / Windows / Linux / iOS / Android
• 核心功能：双向链接（backlinks）、图谱视图（graph view）、全文搜索、插件生态（2000+）、Canvas 白板

价格

项目	价格
个人使用	免费，无限制
Sync（跨设备同步）	$4-5/月
Publish（发布到网页）	$8-10/月
商业用途	$50/用户/年（鼓励但不强制）

与当前 Wiki 项目的兼容性

当前 Wiki 使用 MkDocs Material + 纯 .md 文件 + Git，可以直接把 wiki 目录作为 Obsidian Vault 打开。

兼容项

• 纯 .md 文件：完全兼容
• 中文内容：完全兼容
• Git 工作流：兼容（.obsidian/ 加到 .gitignore）
• 现有 Python 脚本（日历等）：无影响
• blockquote 头部格式：Obsidian 不修改它不理解的语法

需注意

1. Wikilinks：Obsidian 默认用 [[文件名]]，MkDocs 不认。需在 Settings → Files & Links → 关闭 "Use Wikilinks"，改为标准 markdown 链接
2. Callout 语法差异：Obsidian 用 > [!note]，MkDocs Material 用 !!! note。可安装 mkdocs-obsidian-bridge 插件桥接
3. .obsidian/ 目录：Obsidian 会在 Vault 根目录创建，需加到 .gitignore

相关 MkDocs 桥接插件

• mkdocs-obsidian-bridge（pip，BSD-3）— 自动转换 Obsidian 语法
• mkdocs-obsidian-support-plugin（GitHub，MIT）— wikilinks + callout 转换
• mkdocs-publisher（GitHub）— 完整的 Obsidian → MkDocs 发布工作流

Obsidian MCP（结论：不需要）

存在多个 Obsidian MCP Server 项目（smithery-ai/mcp-obsidian 588 stars、cyanheads/obsidian-mcp-server 380 stars），但对当前工作流 没有价值：

• Claude Code 已有完整文件系统权限，MCP 的读写搜索能力完全重复
• MCP 多一层协议开销，不省 token（最终注入 context 的文本量相同）
• 多一个硬依赖：Obsidian 必须在后台运行

Token 消耗取决于读入的内容量，不取决于读取通道。 当前按领域分离 MEMORY 文件 + 按需加载的架构已经是较优方案。

结论

Obsidian 适合作为 wiki 的可视化浏览和编辑层，与 MkDocs Material 互补（一个编辑、一个发布）。零成本、零风险、零迁移。但不需要 Obsidian MCP。