Joplin 迁移到 Obsidian：笔记导出完整流程

一、迁移前先做两件事

先导出 JEX 完整备份。JEX 是 Joplin 的无损格式，笔记、附件、标签都在里面，迁移出问题可以整个导回，操作见 Joplin 数据备份与恢复实战。

再决定导出范围：只转一部分就右键单个笔记本导出，全部转用「导出全部」。小笔记库建议先转一个笔记本试跑，确认图片能显示再全量操作。

二、官方导出：文件 → 导出全部 → MD

桌面端点 文件 → 导出全部，选「MD - Markdown」。Joplin 会生成一个目录：笔记本按子目录排列，每篇笔记一个 .md，所有附件集中在 _resources 文件夹，图片保留原名。想保留创建时间、标签等元数据，就选「MD - Markdown + Front Matter」，元数据写进 YAML 头。官方说明见 Joplin 官方导入导出文档。

右键单个笔记本或单条笔记，菜单里也有 导出 → MD - Markdown，适合只迁一部分。

三、核心难点：处理 :/ 资源链接

Joplin 内部用 :/32位ID 或 joplin://32位ID 引用图片和笔记。导出时，:/ 形式的资源链接会被改写成相对路径（比如 ../_resources/截图.png），Obsidian 能直接渲染。但 joplin:// 形式的内部链接在部分版本导出时不会被改写，这是 GitHub 上登记过的已知问题（issue #16348）。

处理办法：导出后全局搜索 joplin:// 和裸 :/ 链接，替换成相对路径，或统一改成 ![[_resources/文件名.png]]。文件名带空格的，Obsidian 有时不认，把空格转成 %20。

四、把导出目录变成 Obsidian vault

Obsidian 里点「打开本地仓库」，选择刚才的导出目录，或者移动进已有仓库。然后在 设置 → 文件与链接 → 附件默认存放路径 填 _resources，以后新粘贴的图片会落到同一文件夹。Obsidian 官方客户端在 obsidian.md 下载。

打开后先抽查几篇带图片的笔记，确认渲染正常。

五、检查标签、front matter 与兼容性

用「MD - Markdown + Front Matter」导出，标签会写进 YAML 的 tags 字段；用纯 MD 导出，标签会丢，需要重新整理。代码块、表格、- [ ] 待办复选框 Obsidian 都兼容，Markdown 基础可回看 Joplin Markdown 知识库教程。

Mermaid 图在 Obsidian 里需要额外支持；Joplin 插件生成的语法块只会显示成普通代码。

六、第三方工具与替代方案

社区里有 joplin2obsidian、Yanom 这类转换工具，能把 :/ 链接批量转成 Obsidian 格式。但它们维护频率不一，质量参差，小笔记库建议手动核对，别指望一键完美迁移。

迁移完成后，JEX 备份先留着。如果 Obsidian 用不惯想回来，随时可以导回，两边对比可看 Joplin vs Obsidian 详细对比。

七、常见问题

导出后图片不显示？

先看链接是相对路径还是 joplin://：前者检查路径层级，后者按「处理 :/ 资源链接」一节的方法替换成相对路径。

标签全丢了？

确认导出时选的是「MD - Markdown + Front Matter」，纯 MD 导出会丢标签。

迁移后还能继续用 Joplin 吗？

能。迁移前导出的 JEX 备份还在，随时可以重新导入。

从 Joplin 导入 Obsidian 没有官方一键按钮，本质就是「导出 Markdown + 修链接」两步，小笔记库半天能搬完。