飞书负责协作，Obsidian 负责长期积累。两边连起来时，很多人先想到双向同步，结果很快被冲突、重命名和权限问题拖住。
如果目的只是把完成的资料放进 vault，单向导出更省事，也更容易检查。
双向同步为什么更复杂
双向同步至少需要处理四类问题：
- 在飞书和 Obsidian 两边同时修改后，哪一版覆盖哪一版。
- 删除、重命名和移动文件夹如何保持一致。
- 图片、附件和内部链接如何映射。
- 飞书改版或插件停更后，同步是否还能继续。
如果目标是“把飞书里的资料搬进 vault 后长期阅读”，双向同步带来的维护成本通常超过收益。
迁移前先在飞书里整理
- 合并过于复杂的表格，确认合并单元格是否有必要。
- 把重要评论补充进正文，评论通常不会随 Markdown 导出。
- 删除已经失效的临时链接和重复文档。
- 确认每个页面的标题和层级。
- 只选择你有权保存的内容。
这一步会直接影响导入后的可用性，比事后在 Obsidian 里修改更省时间。
Obsidian 需要什么样的 Markdown
一个适合放进 vault 的文档，通常需要：
| 项目 | 推荐结果 |
|---|---|
| 正文 | 标题、列表、表格、代码块完整 |
| 图片 | 放在 assets 或附件目录，使用相对路径 |
| Frontmatter | 至少包含标题、来源和导入时间 |
| 文件夹 | 与飞书的知识库层级大体对应 |
| 内部链接 | 失效的飞书链接单独标记 |
如果图片仍是 CDN 链接，刚导入时看起来正常，离开账号或断网后就会裂图。
一条可执行的迁移路线
第一步，导出 Markdown 和图片
使用能同时保存正文与图片的方式导出。飞书文档转 Markdown 免费；图片 ZIP 打包属于 Pro，适合图片较多的文档。
第二步，在工作区外先检查
不要把刚导出的文件直接拖进主 vault。先在一个临时文件夹里抽查：
- 随机打开三篇文档，检查标题层级。
- 看图片是否真实存在。
- 搜索一个只出现过一次的关键词，确认正文没有缺段。
- 移动整个文件夹，确认路径没有断开。
第三步，按主题放进 vault
推荐把飞书来源和其他个人笔记分开：
vault/
├── 00-inbox/
├── feishu-archive/
│ ├── project-a/
│ └── project-b/
└── assets/如果同一个 vault 里有多个来源，可以在 frontmatter 中保留 source 和 imported_at，方便以后追踪。
第四步，检查搜索和链接
导入后先不要急着加标签。先检查全文搜索、文件标题和图片。确认基础内容可用后，再整理标签和双链。
哪些内容不适合搬进笔记库
大文件、视频、可执行附件和机密资料不适合全部塞进 Obsidian。它们会增加 vault 体积，也可能带来权限和备份风险。
另外，不建议把仍在频繁协作更新的飞书文档当作个人笔记持续维护。单向归档应该保留一个清晰时间点，而不是假装两边永远同步。
什么时候再考虑同步插件
只有当你明确需要“在 Obsidian 修改后自动回到飞书”，并且愿意处理冲突、凭证和维护问题时，才值得研究双向同步。
如果只是偶尔补充一句，最简单的办法仍然是回到飞书修改，等资料稳定后再重新导出。单向路线少一个后台系统，也多一份可控。