Notion 转 Obsidian 迁移指南：API 与 HTML 导入对比及检查清单

从 Notion 迁移到 Obsidian 的最安全方式取决于您的工作区包含哪些内容。当数据库和公式至关重要时，请使用官方的 Notion API 导入。当您希望进行免 Token 密钥、离线迁移且能够自行重建数据库视图时，请使用 Notion HTML 文件导入。

切勿将迁移仅仅视为一次简单的文件复制过程。首先确定哪些工作流必须保留：双链笔记、项目记录、每日计划、定期任务、会议记录或数据库视图。然后将其导入测试仓库，验证关键工作流，在新的仓库通过本指南末尾的检查清单之前，请保持 Notion 处于可用状态。

快速决策：选择 API 还是 HTML 导入？

您的实际情况	推荐选择	能保留的内容	主要权衡与代价
数据库、属性和公式是核心	Notion (API)	页面、数据库条目、属性及公式将转换为 Markdown 和 Bases 视图	需要 Notion 集成 Token、页面访问权限及网络连接
希望过程免 Token 或完全离线	Notion (.zip)	包含来自 HTML 导出的页面、附件、层级和链接	数据库视图和数据库结构不会作为实时 Bases 转换
只需要迁移一小部分笔记	API 导入（限制仅访问这些页面）或页面级 HTML 导出	选定的笔记及其可用的附件	指向选定范围之外内容的链接需要后续人工复核
需要实时团队协作与权限控制	将该协作工作流留在 Notion 或将 Obsidian 与团队工具结合使用	知识上下文仍可迁移至 Obsidian	Obsidian 并不是共享 Notion 工作区的直接替代品

本表反映了最新的 Obsidian Importer 官方文档。API 导入器是一项新特性，因此在大规模迁移前请务必了解其局限性。特别是，每个数据库仅导入主视图，不导入链接的数据源，部分 Notion 函数无法直接转换。

迁移前准备

整理一份简短的资产清单。将每一项标记为必须保留、重新构建或直接归档。

• 您仍在使用中的笔记和嵌套页面。
• 内部链接、反向链接（Backlinks）及重要附件。
• 数据库、属性、关联（Relations）、Rollup 汇总、公式和视图。
• 日记、定期任务、项目状态及会议跟进。
• 共享页面、评论、权限、自动化及集成。
• 新本地仓库的备份与同步路径。

利用该清单选择合适的导入路径。一个包含大量数据库的复杂工作区需要与单纯的会议笔记文件夹截然不同的迁移计划。如果您在迁移前希望了解更广泛的对比，请阅读 Obsidian 与 Notion 生产力对比。

创建安全的测试边界

1. 保持原始 Notion 工作区完全不变。
2. 创建一个新的空 Obsidian 测试仓库（Vault）。
3. 先导出或导入一个代表性样本：一个普通页面、一个嵌套页面、一个带链接的页面、一个附件和一个数据库。
4. 记录哪些成功导入，哪些需要重新构建。
5. 只有在样本测试完全通过后，才在正式目标仓库中重复该操作。

测试并不能保证每个工作区的表现都完全一致。它能提前暴露您工作区中需要在放弃旧系统前重新设计的部分。

选项 1：通过 Notion API 导入

当数据库及其属性非常重要时，请使用此路径。官方 Importer 插件会将 Notion 数据库转换为带有 .base 文件的文件夹，并在 Obsidian 支持对应功能的情况下转换公式。

准备 Notion 集成

1. 打开 Notion 集成页面。
2. 为工作区创建一个内部集成（Internal Integration）。
3. 将生成的内部集成密钥（Secret）复制并保存到安全的密码管理器中。
4. 赋予该集成访问您希望导入的页面和数据库的权限。

切勿将 Token 粘贴到文章、终端历史记录、Issue 或共享笔记中。该 Token 拥有访问您共享给该进成的所有内容的权限。

执行 API 导入

1. 在 Obsidian 中打开 设置 → 社区插件。
2. 安装并启用官方 Importer 插件。
3. 从命令面板或左侧边栏图标打开 Importer。
4. 选择 Notion (API) 作为文件格式。
5. 粘贴集成密钥并选择 加载 (Load)。
6. 选择要导入的页面和数据库。
7. 检查导入选项并开始导入。

大型工作区可能需要较长时间，因为 Notion API 存在速率限制（Rate limits）。请确保在向正确的父页面授予访问权限后再开始导入。关于 Importer 丢失页面的已知问题 表明，当选择列表显示不完整时，需要重点检查访问权限范围和页面层级关系。

需提前规划的 API 局限性

官方文档指出了以下限制：

• 每个数据库仅导入主视图。
• 不导入链接的数据源（Linked data sources）。
• People 人员函数（如 name() 和 email()）不会被转换。
• Text 文本函数（如 style() 和 unstyle()）不会被转换。
• 没有合适 Obsidian 函数对应的公式需要人工核对。

请将导入的 .base 文件视为初始视图，而不是每个 Notion 视图都完好无损的证明。请务必检查关联关系、公式、筛选器以及您日常工作依赖的记录。

选项 2：导入 Notion HTML 导出文件

当您希望免 Token 密钥或工作区主要由页面和附件组成时，请使用文件导入。Obsidian 推荐在此路径下使用 HTML 导出，因为 Notion 的 Markdown 导出体会遗漏重要数据。

从 Notion 导出

1. 打开 Notion 中的 设置 → 工作区 → 通用。
2. 选择 导出所有工作区内容。
3. 选择 HTML 作为导出格式。
4. 选择 包含所有内容。
5. 启用 为子页面创建文件夹。
6. 请求并下载 .zip 导出文件。

Notion 官方导出文档 确认，工作区导出可包含 HTML、Markdown、CSV 文件和已上传的资源。文档同时指出，数据库视图和部分工作区内容无法导出为完全可重建的工作区。

导入 .zip 文件

1. 在 Obsidian 中打开官方 Importer 插件。
2. 选择 Notion (.zip)。
3. 选择导出的压缩包文件。
4. 选择输出文件夹。
5. 如果希望保留页面层级，请启用 在子文件夹中保存父页面。
6. 当整个工作区的内部双链至关重要时，请导入完整的导出包。

该路径将页面和资源导入本地 Markdown 仓库中，但不会将 Notion 数据库保留为实时数据库视图。在明确哪些工作流需要重新构建之前，请勿安装大量插件。

仅重建您仍在使用的工作流

导入的归档文件还不是一个可运行的系统。请从每个活跃工作流的最简化替代方案开始。

Notion 工作流	Obsidian 起步方案	在关闭 Notion 前需验证的事项
文档与参考页面	Markdown 笔记、文件夹、搜索与内部双链	打开 5 个重要页面并测试其链接
项目或任务数据库	API 导入的 Bases，或带筛选视图的属性	按状态、到期日和一个真实项目进行筛选
日常计划	核心日记插件加模板	为今天创建一份笔记，确认模板与文件夹
周期性工作	Tasks 插件或简单的周期笔记规范	创建、查询并完成一项定期任务
会议与联系人	链接至项目和人员的会议笔记	从会议和项目上下文中找到一项待办动作
共享审批与评论	将协作工作流保留在 Notion 或团队工具中	确认谁仍需要访问权限和通知通知

对于开箱即用的本地优先系统，Obsibrain 的任务管理、每日计划、智能项目 以及 定期复盘 覆盖了迁移中通常需要的绝大部分高级功能。

如果您更喜欢自己动手搭建系统，请从 Obsidian 中的 PARA 方法 或 第二大脑配置 开始。只有在存在无法解决的实际需求时，再添加数据库视图或社区插件。

迁移验收检查清单

在将 Notion 设置为只读或取消付费计划前，请执行此项检查。

内容与链接

• 所有必须保留的页面均已存在于新仓库中。
• 嵌套页面位于预期的文件夹或链接结构中。
• 重要的内部链接可以正常打开目标笔记。
• 重要的图片、PDF 及其他附件可以在本地打开。
• 搜索可以找到您每周使用的页面和属性。

数据与视图

• 对当前工作至关重要的数据库行已存在。
• 属性具有预期的名称和数据类型。
• 关联（Relations）指向正确的笔记或有明确记录的备选方案。
• 公式和 Rollup 具有经过测试的替代方案或已记录的限制。
• 主要的项目、任务或联系人视图能够解决实际需求。

日常使用与退出

• 新的日记能使用正确的模板保存在正确的文件夹中。
• 任务可以从捕获平滑移动到完成，且无重复。
• 会议待办项与其来源上下文保持关联。
• 仓库已配置备份和多设备同步方案。
• 在日常工作通过检查清单前，Notion 仍保持可用状态。

常见问题排查指南

异常现象	首要检查项	实用应对措施
API 导入未显示页面或数据库	集成访问权限与父页面共享设置	共享正确的父页面，重新加载选择列表，先测试小范围
数据库导入后缺少预期视图	主视图与链接数据源限制	在 Bases 中重新构建缺失视图，或将该工作流留在 Notion
公式行为与原先不一致	Obsidian 是否有对应的替代函数	将计算结果保留为属性，并记录原始公式
HTML 导入包含乱码或格式缺失	导出格式与附件路径	使用 HTML 格式，保持导出包完整，优先修复高价值笔记
导入后仓库感觉极为杂乱	迁移是否复制了冷归档而非工作流	归档旧资料，围绕您仍在使用中的笔记构建系统

Obsidian Importer 问题追踪器 是了解当前边界情况的最佳场所。

最终建议

对于数据库密集的复杂工作区，请选择 API 导入。对于以页面为主、免 Token 的迁移，请选择 HTML 导入。无论采用哪种方式，请始终使用测试仓库，保留原始导出文件，并且只重建仍有价值的工作流。

迁移的目标不是 100% 复制 Notion 的每一个视图。目标是建立一个本地的、连接顺畅的系统，帮助您捕获灵感、管理项目、规划日常并复盘承诺。如果搭建工作是主要障碍，请直接使用开箱即用的 Obsidian 系统；如果团队协作是核心需求，请将该部分保留在专门为团队设计的工具中。

参考来源与延伸阅读

• Obsidian: Import from Notion 官方帮助文档
• Notion: Export your content 官方帮助文档
• Obsidian Importer Issue 问题追踪器
• Obsidian Importer Issue: 丢失页面或数据库反馈