Blog
飞书文档转 Obsidian 完整指南 — 构建本地知识库
问题背景
飞书写文档方便,但数据是"云端租的"。想做真正的个人知识库,很多人转向 Obsidian:本地优先、双向链接、插件生态强。难点是——飞书官方只能单篇导出 Markdown,知识库整库不支持,图片还是外链,换设备可能失效。
本文给出一条路径:用 MZilo 把飞书文档批量归档为带层级目录的本地 Markdown 包,再导入 Obsidian。
现有方案对比
| 方案 | 优点 | 缺点 | 适合谁 |
|---|---|---|---|
| 飞书官方单篇导出 | 免费 | 逐篇点、图片外链、无层级 | 少量文档 |
| 手动复制 | 零门槛 | 量大不可能、图片丢 | 不推荐 |
| MZilo 批量归档 | 浏览器扩展即用、图片本地化、保留层级 | 免费5次起步 | 大知识库、非技术用户 |
详细操作步骤
第一步:确认迁移范围。 打开飞书,列出个人空间 + 参与的知识库。提前规划 Obsidian vault 的目录结构。
第二步:用 MZilo 批量归档。 安装并登录 MZilo,在飞书文档列表勾选要迁移的文档,选 Markdown,勾选"下载图片到本地"。MZilo 保留知识库的树状目录。
第三步:得到本地 Markdown 包。 导出文件夹内含 .md + 同名图片文件夹,相对路径引用,离线可读。
第四步:导入 Obsidian。 整个文件夹拖进 Obsidian vault,图片自动显示,Markdown 直接识别。
第五步:建立双链。 Obsidian 的 [[ ]] 不会自动生成,可在相关笔记间手动加链接,或装 "Note Refactor" 等插件。
进阶技巧
- 附件路径:Obsidian 设置里把附件存到
/assets,和 MZilo 导出结构保持一致。 - 标签体系:用
#主题标签替代飞书的目录分类,检索更快。 - 图谱视图:用 Graph View 看知识关联,这是飞书没有的。
总结
飞书转 Obsidian 的痛点不是"能不能导",而是"整库+图片+层级"兼得。官方单篇导出做不到,MZilo 用浏览器扩展把这件事压到半小时以内。数据回到自己手里,才是真知识资产。
- 相关教程:飞书文档导出为 Markdown | 飞书平台归档合集 | Markdown 导出合集
- 延伸阅读:语雀知识库迁移到 Obsidian | 知识资产归档方案
立即 安装 MZilo,免费 5 次额度先试一篇。