先为源飞书 URL 建一张本地笔记路径对照表,再逐批替换已确认的链接。对同名笔记使用带路径的双链,保留尚未迁移的原链接,并用标签标记待复核的笔记。
把飞书 Markdown 放进 Obsidian 库后,点一下「上线流程」。如果浏览器跳回飞书,说明正文里的链接仍指向源文档。如果打开了另一个团队的同名笔记,就需要把目标写到文件夹一级。下面用一小批文档演示怎么分别处理。
先给五篇笔记做一张链接对照表
用飞书工具箱导出几篇彼此引用的文档为 Markdown,放进一个测试库。导出结果如果有图片目录,一并复制并保留相对位置。为每篇笔记记下完整源 URL 和本地路径。例如两篇都叫「上线流程」,可以分别落在 产品/上线流程.md 和 运维/上线流程.md。
把完整 URL 当成查找依据。同一标题可能属于不同知识库,标题相同的两行也应保留各自的 URL。遇到只链接到某个小节的地址,单独记录片段目标,等正文标题核对完再替换。
按链接类型处理
| 正文里的目标 | 处理方式 |
|---|---|
| 已导入且有明确映射的飞书文档 | 改为 [[运维/上线流程|上线流程]],保留读者看到的原名称 |
| 尚未导入或仍需在线协作的文档 | 保留原链接,另在对照表记下待处理原因 |
| 同一笔记的小节 | 核对目标标题后使用 [[运维/上线流程#回滚]] |
| Markdown 图片或普通外部网页 | 保留对应的图片语法或外链 |
先改一篇并点击每个目标。确认同名笔记和小节都能落在正确位置,再处理同一批里的其他笔记。如果还要交付给使用普通 Markdown 编辑器的同事,可以保留一份原始导出,或在交付版本使用相对 Markdown 链接。
标签只记录需要筛选的信息
在测试批次用 #migration/needs-review 标记链接待复核的笔记,用 #migration/checked 标记已经点验的笔记。已有项目标签就继续沿用。一个项目的「上线流程」和「回滚记录」可以同属一个项目标签,两篇之间再用双链表达它们的关系。
发布前查一遍 needs-review,每篇抽查源文档入口、同名笔记、标题锚点和一张本地图片。确认通过后,再把这套规则用于下一批。保留源 URL 对照表,后面补导文档时可以直接找出哪些旧链接能转成本地双链。