2026 年 Obsidian 迁移到 Notion 完整指南
我们全面而详尽地盘点了 2026 年要如何从 Obsidian 迁移到 Notion。以下是我们的研究成果：
现有方法
路径一：Notion 内建 ZIP 导入
Notion 后台「Settings → Import → Markdown & CSV」可以使用 Zip 导入，直接支持 Obsidian 等 markdown-like 格式，这是最多人会尝试的第一条路。
它能正确处理：标题、粗体斜体、清单、代码块、表格、LaTeX、标准 Markdown 链接 [文字](url)。
但是 Obsidian 大量使用的扩展语法，Notion 却完全不支持：
- Wikilink
[[页面名称]]— 变成纯文本方括号，所有笔记之间的链接全部断掉 - Callout
> [!note]— 变成普通引用块，图标和颜色都消失 - 嵌入图片
![[image.png]]— Notion 不认这个语法，直接当文字显示 - YAML frontmatter —
---包起来的 metadata 整段摊在页面顶端 - 行内标签
#tag— 不会变成 Notion 标签，停留为纯文本 - 文件夹结构 — 部分保留，但 Notion 官方文档没明确规范
除了以上格式会掉之外，迁移过程大概最容易踩到的是免费方案的限制（5MB，付费版则是 5GB），而官网甚至提到超过 10000 个文件的导入也有可能会坏掉，即使没有超过文件大小限制。
路径二：第三方脚本
若 Notion 官方的导入不合意，GitHub 上找得到几个 obsidian-to-notion 项目，但大多状况不佳：
Cobertos/md2notion— 2023 年封存，依赖 Notion 已弃用的非公开 APIEasyChris/obsidian-to-notion— Obsidian 插件，2023 年后停止维护，而且一次只能转一页p-meier/obsidian-to-notion/JimBarrows/obsidian-to-notion— 小型 Python 脚本，star 数个位数，需要自己配置 API token，callout 之类的扩展语法支持不完整
实务上，这些工具大概没办法当正式环境的方案使用。除了没人维护之外，还需要踩很多坑才可以转一些页面，工具也没办法保证转换完的品质。
路径三：手动复制粘贴
Notion 的编辑器在粘贴时会解析 Markdown，所以一页一页复制粘贴确实可行，标题、粗体、清单、表格、代码都会正确转换。
但：
- Wikilink 还是纯文本，要手动用
@重新建链接 - 200 页的 vault 大概要花 1–2 小时
- 容易漏、容易连错
路径四：Pandoc / HTML 中介
Obsidian 用 Pandoc 或 Webpage HTML Export 插件转成 HTML，再粘贴到 Notion。这个方法可以保留一部分样式，但需要自己组 pipeline，没有现成的端到端方案，而且 wikilink 照样断掉。这个项目也在 2022 年之后就没有人维护了。
路径五：不迁移，双开两个工具
直接放推——这是 Reddit 上 r/Notion、r/ObsidianMD 最常见的建议：Notion 拿来做团队协作和数据库，Obsidian 拿来写个人笔记。
双开的问题是长期维护成本——同一份信息两边都要更新、搜索要搜两次、团队成员看不到你个人 vault 里的内容。如果你想迁移，通常是因为这些痛点已经累积够久了。
共同的核心问题
把上面四个可行的路展开，我们可以发现有一些共同的失败特征：
- Wikilink 失效 — 没有工具能跨文件解析
[[]]并建立 Notion 的真实页面链接 - Obsidian 扩展语法不兼容 — Callout、highlight、frontmatter、嵌入语法在 Notion 通通会掉
- 附件遗失 — 本地图片、PDF、音频文件没办法跟着上传
- 年久失修 — 多数工具已弃置，依赖的 API 早已换代
- 不可规模化 — 几百页的 vault 手动一页一页修问题不切实际
Notion 官方目前看起来不打算完整支持 Obsidian 语法，而是把 Zip 上传当成一个通用的 Markdown 导入方法。而 Obsidian 为了个人知识管理扩出了一整套语法，这些东西在 Notion 端没有对应的原生概念（或是要细致地处理很麻烦），这就是目前的现况。
Note Bridge 做了什么
我们开发 Note Bridge 的 Obsidian to Notion 功能，目标就是把上述每个问题都从根本解决：
Wikilink：两段式扫描
Wikilink 坏掉的根本原因是前向引用——当导入工具看到 [[笔记B]] 时，笔记 B 还没在 Notion 建出来，自然没有页面 ID 可以连。
Note Bridge 的做法是两段式扫描：
- 第一段：把所有选取的笔记在 Notion 建好页面，同时记下「Obsidian 文件名 → Notion 页面 ID」对照表
- 第二段：回头逐页填内容，碰到
[[]]时去对照表查出目标页面 ID，建立真正的 Notion 页面 mention
除此之外，[[页面|别名]] 的用法也完整保留、![[图片.png]] 这种文件的引用，则会去 vault 里找文件上传到 Notion。
三状态链接，避免假链接
不是所有 wikilink 的目标都会被迁移——用户可能只勾选一部分页面、有些链接指向的文件根本不存在。Note Bridge 会把链接分成三种状态渲染：
- 目标在 vault 且有迁移 → Notion 页面链接
- 目标在 vault 但这次没迁 →
页面名称 (not migrated)纯文本 - 目标根本不在 vault →
⚠️ 页面名称警告纯文本
这样用户打开 Notion 后，一眼就能看出哪些链接是有效的、哪些需要后续补迁。
自动把相关页面带进来
只勾选一页、但这页连到另外 30 页怎么办？Note Bridge 会在迁移前先做展开——递归追踪每篇被选中的笔记的 wikilink 和附件，把整个关联网络显示出来，让你决定要不要一起迁移。预设勾选，但可以单独取消勾选。
Obsidian 特有语法处理
| 语法 | Note Bridge 处理方式 |
|---|---|
Callout > [!type] |
支持 25 种类型（note / warning / danger / tip 等），转成带 emoji 标题的引用块 |
Highlight ==文字== |
转成 Notion 的黄色背景标记 |
行内数学 $x^2$ / 块级数学 $$...$$ |
转成 Notion equation 区块 |
Footnote [^1] |
脚注定义会被内联到引用处，显示为 (footnote: ...) |
注释 %%...%% |
移除（符合 Obsidian 原本「隐藏」的语意） |
| YAML frontmatter | 转成页面顶端的 Metadata 折叠区块 |
行内标签 #tag |
保留为 `#tag` 格式（不映射到 Notion 标签属性） |
| Dataview 查询 | 不执行，保留原始查询内容并标记「Notion 不支持」 |
附件处理
![[图片.png]]、PDF、音频（mp3/wav/flac）、视频（mp4/webm）都会从 vault 里找出来，通过 Notion API 上传到目标位置。目前仅支持单文件 5MB（对齐 Notion 免费版本限制），超过大小的文件会在迁移报告里列出。
文件夹结构
Vault 的多层文件夹会对应到 Notion 的多层页面，深度没有上限。即使你只勾选某文件夹深处的一页，中间的父页面也会被建出来，以保持原本的结构。
Notion 内建导入 vs Note Bridge — 对比表
| 功能 | Notion 内建导入 | Note Bridge |
|---|---|---|
| 标题、粗体、清单等基本 Markdown | ✅ | ✅ |
| 代码块（含语言标记） | ✅ | ✅ |
| 表格（含项目清单内的表格） | 部分 | ✅ |
| LaTeX 数学公式 | ✅ | ✅ |
外部 [文字](url) 链接 |
✅ | ✅ |
Wikilink [[页面]] |
❌ 变纯文本 | ✅ Notion 页面 mention |
Wikilink 别名 [[页面|显示名称]] |
❌ | ✅ 保留别名 |
嵌入图片 ![[图片.png]] |
❌ | ✅ 上传到 Notion |
Callout > [!note] |
❌ 变普通引用 | ✅ 25 种类型，带 emoji |
Highlight ==文字== |
❌ 显示等号 | ✅ 黄色背景标记 |
| YAML frontmatter | ❌ 原始文本 | ✅ Metadata 折叠区块 |
脚注 [^1] |
❌ 消失 | ✅ 内联到引用处 |
Obsidian 注释 %%...%% |
❌ 外泄成可见文本 | ✅ 正确隐藏 |
| 本地图片、PDF、音频 | ❌ 无法上传 | ✅ 上传到 Notion |
| 文件夹结构 | 部分保留 | ✅ 完整对应 |
| 跨文件链接解析 | ❌ | ✅ 两段式处理 |
| 不存在的链接提示 | ❌ 静默坏掉 | ✅ 三态标示 |
实际使用流程
Note Bridge 的 Obsidian 迁移分四步：
步骤一：选择 Notion 目的地
绑定 Notion 帐号后，选择你要把笔记放进 Notion 的哪一页底下。
步骤二：选取你的 Obsidian Vault
Note Bridge 用文件夹选取而不是 ZIP 上传——直接从浏览器选取 Vault 文件夹，不用先压缩、不用安装任何插件。.obsidian/、.git/、.DS_Store 这类系统文件会自动跳过。
步骤三：勾选要迁的笔记，确认迁移内容
浏览 vault 结构，勾选要迁的笔记。Note Bridge 会自动展开，把这些笔记连到的其他页面、引用的图片附件也一起列出来。确认页面会显示：
- Selected — 你直接勾选的笔记
- Closure — 被链接到所以自动带进来的笔记
- Attachments — 引用到的图片、PDF、音频
- Skipped — 超过 5 MB、不支持的格式（
.canvas等）会被跳过并列出原因
每一类都可以单独取消勾选。底下会即时显示这次迁移要付多少钱。
步骤四：开始迁移
按下开始后，Note Bridge 会在后台跑两段式处理。你可以关掉窗口去做别的事，迁完会发邮件通知。完成后可以打开迁移报告，看每一页的转换状况、哪些链接被解析成功、哪些附件被跳过。
无法迁移的内容
目前还不支持的内容：
- Mermaid 图 — 保留为代码块但不会被渲染成图（Notion API 不支持 Mermaid 渲染）
.canvas文件 — 不支持，会列在 Skipped 清单- Dataview 查询 — 不执行，会保留原始查询文本并加上「不支持」标记
- YAML frontmatter 不会自动映射成 typed Notion properties — 只会渲染成可读的 Metadata 区块
如果某项对你来说是必要功能，欢迎回信告诉我们，会帮助我们判断优先顺序。
结论
Obsidian 是非常好的个人知识管理工具，但当你的需求变了——团队协作、跨设备编辑、想分享页面给没装 Obsidian 的人——迁移不应该是一件令人挫折的事。
Obsidian 自己的 Markdown 格式目前不被 Notion 官方工具完整支持，Note Bridge 的做法就是把这些差异一个一个写成转换规则，并用两段式处理解决跨文件链接的问题。
试试 Note Bridge。前 20 页免费。
延伸阅读：OneNote 迁移到 Notion 完整指南。想了解 Note Bridge 工程方面的故事，可以看 Microsoft Graph API 限流实战。