Blog
语雀知识库迁移到 Obsidian — 完整指南
问题背景
语雀好用，但越来越多人想把知识库搬到 Obsidian：本地优先、数据自有、双向链接、插件生态。难点在于——语雀官方只支持单篇导出 Markdown，知识库整库要逐篇点，图片还是图床链接，换设备就可能失效。一个几百篇的知识库，手动迁移几乎不可能。
本文给出一条可行路径：用 MZilo 把语雀知识库批量归档为带层级目录的本地 Markdown 包，再导入 Obsidian。
现有方案对比
| 方案 | 优点 | 缺点 | 适合谁 |
|---|---|---|---|
| 语雀官方单篇导出 | 免费 | 逐篇点、图片图床链接、无层级 | 少量文档 |
| yuque-exporter（开源） | 可批量 | 需 Node.js、命令行、Token，门槛高 | 开发者 |
| MZilo 批量归档 | 浏览器扩展即用、图片本地化、保留层级 | 免费5次起步 | 非技术用户、大知识库 |
详细操作步骤
第一步：整理迁移范围。 在语雀里确认要迁移的知识库，评估体量。Obsidian 对本地 Markdown 支持极好，基本不用改格式。
第二步：用 MZilo 批量归档。 安装并登录 MZilo，打开语雀知识库，在列表勾选所有文档（或整库），选择导出 Markdown，勾选"下载图片到本地"。MZilo 会保留知识库的树状目录结构。
第三步：得到本地 Markdown 包。 导出的是一个文件夹，里面是带层级子目录的 .md 文件 + 同名图片文件夹。相对路径引用图片，离线可读。
第四步：导入 Obsidian。 把整个文件夹拖进 Obsidian 的 vault 目录。Obsidian 自动识别 Markdown，图片直接显示。
第五步：补全双向链接。 Obsidian 的 [[ ]] 双链不会自动从语雀生成，但你可以逐步在相关笔记间手动加链接，或装 "Note Refactor" 等插件辅助。
进阶技巧
- 附件管理：在 Obsidian 设置里把附件默认存到
/assets，保持和 MZilo 导出结构一致。 - 标签体系：迁移后给核心笔记打
#标签，替代语雀的目录分类。 - 图谱视图：用 Graph View 看知识关联，这是语雀没有的能力。
总结
语雀知识库迁移到 Obsidian 的痛点不是"能不能导"，而是"整库+图片+层级"三者兼得。官方单篇导出做不到，开源工具门槛高，MZilo 用浏览器扩展把这件事降到半小时以内。数据回到自己手里，才是真正的知识资产。
- 相关教程：语雀文档导出为 Markdown ｜ 语雀平台归档合集 ｜ Markdown 导出合集
- 延伸阅读：飞书文档转 Obsidian ｜ 知识资产归档方案 ｜ 语雀导出工具哪个好
立即 安装 MZilo，免费 5 次额度先试一篇。