我把幕布里三年的笔记搬进了Obsidian——零代码迁移全记录 | 幕布导出工具

我把幕布里三年的笔记搬进了Obsidian——零代码迁移全记录

6分钟 阿辰 · 效率工具指南

大家好，我是阿辰。

用了三年幕布，攒了 300 多篇读书笔记和项目复盘文档。去年开始折腾 Obsidian 之后，一直想把幕布里的内容搬过来统一管理。但一想到要手动导出几百个文件，就一拖再拖。直到上周末我终于下定决心——结果整个过程比我预想的简单太多了。

TL;DR：使用 Mubu Exporter 插件可在 20 分钟内将幕布全部笔记迁移到 Obsidian。流程：安装插件(2分钟) → 批量导出 Markdown(10分钟) → 拖入 Obsidian Vault(5分钟)。文件夹结构和备注内容完整保留，零代码操作。

为什么我决定从幕布迁移到 Obsidian？

先声明：我不是要彻底抛弃幕布。幕布的大纲编辑确实很好用，写会议纪要和头脑风暴的时候我还是会打开它。但我需要一个本地化的知识库来做长期积累，Obsidian 的几个特性吸引了我：

  • 纯 Markdown 文件——数据完全在本地，不依赖任何云服务
  • 双向链接——笔记之间可以形成网状关系，不只是树状大纲。Obsidian 官方文档将其描述为构建「知识图谱」的核心功能
  • 插件生态——日历、看板、数据视图……几乎能覆盖所有需求
  • 版本管理——配合 Git 可以追溯任何修改历史

问题在于：幕布里三年的内容怎么无损地搬过来？（如果你只需要导出 Markdown 而不一定迁移到 Obsidian，可以直接看幕布导出 Markdown 的完整方案。）

迁移前我踩过哪些坑？

真正动手之前，我在网上搜了一圈「幕布迁移 Obsidian」，发现大部分方案都不够理想：

坑一：手动导出 OPML 再转换

有人推荐先把文档逐篇导出为 OPML，再用 Python 脚本转 Markdown。我试了几篇，发现两个致命问题：

  • 幕布的「备注」内容在 OPML 里直接丢失了，这些备注是我笔记里最有价值的部分
  • 300 篇手动导出？光点击就得点 900 次（每篇至少三次操作）

坑二：网上的 Python 爬虫脚本

GitHub 上有几个用 Python 抓取幕布 API 的项目，但需要自己抓 Cookie、配置环境变量，还得处理分页和限流。对非程序员来说门槛太高，就算对我这个写过代码的人来说，调试起来也很头疼。

坑三：复制粘贴

最笨的办法——直接在幕布里复制内容，粘贴到 Obsidian。格式会乱掉不说，300 篇文档这么操作一遍大概需要两天。

怎样 20 分钟完成全部迁移？

折腾了一圈后，我找到了 Mubu Exporter 这个 Chrome 插件。整个迁移流程变得极其简单：

第一步：安装插件（2分钟）

  1. 在 Chrome 应用商店搜索「幕布导出工具」，点击安装
  2. 确保 mubu.com 已经登录
  3. 点击浏览器右上角的插件图标

第二步：批量导出 Markdown（10分钟）

  1. 点击「获取文件信息」，插件自动扫描出我所有的文档：317 篇，分布在 26 个文件夹里
  2. 导出格式选择 Markdown
  3. 点击「开始导出」
幕布导出工具批量导出界面，显示实时进度

进度条开始跳动。大概 8 分钟后，317 个 .md 文件全部导出完成。中间有 2 篇因为网络抖动失败了，点「重试」立刻恢复——不用从头来。

第三步：导入 Obsidian（5分钟）

  1. 打开 Obsidian，新建或选择一个 Vault
  2. 把导出的整个文件夹直接拖进 Vault 目录
  3. 回到 Obsidian，所有笔记已经出现在左侧文件列表里

因为 Mubu Exporter 导出时自动保留了幕布的文件夹层级，所以我的文档在 Obsidian 里依然是按「读书笔记」「项目复盘」「会议纪要」等分类整理好的，不需要额外整理。

第四步：检查格式质量

我随机抽查了十几篇文档，确认了几个关键点：

  • 幕布的大纲层级 → 转换为 Markdown 无序列表嵌套（层级关系完美保留）
  • 幕布的「备注」→ 转换为引用块（> 备注内容）
  • 加粗、高亮等格式 → 正确转换为 Markdown 语法
  • 文件名和标题 → 自动使用文档标题作为文件名

迁移后我做了哪些优化？

笔记搬进 Obsidian 只是第一步，我又花了一个小时做了些整理工作：

建立 MOC（内容地图）

在 Vault 根目录创建了一个 Home.md，用双向链接把各个分类串起来。比如：

  • [[读书笔记]] → 链接到读书笔记文件夹的索引页
  • [[项目复盘/2024Q1]] → 直接跳到某个季度的复盘文档

配置 Git 自动备份

安装了 Obsidian Git 插件，设置每天自动 commit + push 到私有仓库。这样即使电脑丢了，所有笔记都有远端备份。

设置定期增量同步

我没有完全放弃幕布——新的会议纪要还是在幕布里写（毕竟大纲编辑体验还是它最好）。现在每个月月底我会跑一次 Mubu Exporter，把新内容增量同步到 Obsidian。

有哪些实用的迁移建议？

如果你也准备做类似的迁移，这些经验可能帮到你：

  1. 先导出再整理——不要想着「整理好了再迁移」，那样你永远迈不出第一步
  2. 保留原始结构——Mubu Exporter 导出的文件夹结构就是你在幕布里的组织方式，先用着，后面再慢慢调整
  3. 同时导出一份 JSON——JSON 格式保留了最完整的原始数据，万一 Markdown 转换有什么遗漏，还能从 JSON 恢复
  4. 不要删除幕布上的内容——迁移不是搬家，是复制。两边都留着，直到你确认 Obsidian 端一切正常

写在最后

这次迁移让我意识到一件事：我们之所以在工具之间犹豫不决，很多时候不是因为新工具不好，而是被「历史数据怎么办」这个问题卡住了。一旦数据可以自由流动，选择权就真正回到了我们手里。

如果你也想把幕布笔记迁移到 Obsidian（或者 Logseq、Notion 等任何支持 Markdown 的工具），试试下面的方案——20 分钟，你的知识资产就能拥有第二个家。迁移完成后别忘了建立定期备份习惯，确保新内容也能及时同步。

相关链接：

幕布迁移 Obsidian Markdown 知识管理 数据迁移