飞书导出与迁移

飞书文档导入 Obsidian 后,怎么修双链和整理标签

飞书 Markdown 导入 Obsidian 后仍跳回飞书、同名笔记连错时,按源链接映射修复双链,再用少量标签整理迁移状态。

4 分钟4 min read 发布于 2026/11/4Published 2026/11/4 更新于 2026/11/4Updated 2026/11/4
本页结构 On This Page
直接回答Short Answer

先为源飞书 URL 建一张本地笔记路径对照表,再逐批替换已确认的链接。对同名笔记使用带路径的双链,保留尚未迁移的原链接,并用标签标记待复核的笔记。

把飞书 Markdown 放进 Obsidian 库后,点一下「上线流程」。如果浏览器跳回飞书,说明正文里的链接仍指向源文档。如果打开了另一个团队的同名笔记,就需要把目标写到文件夹一级。下面用一小批文档演示怎么分别处理。

先给五篇笔记做一张链接对照表

用飞书工具箱导出几篇彼此引用的文档为 Markdown,放进一个测试库。导出结果如果有图片目录,一并复制并保留相对位置。为每篇笔记记下完整源 URL 和本地路径。例如两篇都叫「上线流程」,可以分别落在 产品/上线流程.md 和 运维/上线流程.md。

把完整 URL 当成查找依据。同一标题可能属于不同知识库,标题相同的两行也应保留各自的 URL。遇到只链接到某个小节的地址,单独记录片段目标,等正文标题核对完再替换。

按链接类型处理

正文里的目标处理方式
已导入且有明确映射的飞书文档改为 [[运维/上线流程|上线流程]],保留读者看到的原名称
尚未导入或仍需在线协作的文档保留原链接,另在对照表记下待处理原因
同一笔记的小节核对目标标题后使用 [[运维/上线流程#回滚]]
Markdown 图片或普通外部网页保留对应的图片语法或外链

先改一篇并点击每个目标。确认同名笔记和小节都能落在正确位置,再处理同一批里的其他笔记。如果还要交付给使用普通 Markdown 编辑器的同事,可以保留一份原始导出,或在交付版本使用相对 Markdown 链接。

标签只记录需要筛选的信息

在测试批次用 #migration/needs-review 标记链接待复核的笔记,用 #migration/checked 标记已经点验的笔记。已有项目标签就继续沿用。一个项目的「上线流程」和「回滚记录」可以同属一个项目标签,两篇之间再用双链表达它们的关系。

发布前查一遍 needs-review,每篇抽查源文档入口、同名笔记、标题锚点和一张本地图片。确认通过后,再把这套规则用于下一批。保留源 URL 对照表,后面补导文档时可以直接找出哪些旧链接能转成本地双链。