从 Confluence 导入
将你的 Confluence 数据直接导入 Notion 📥
将所有数据集中在一处非常重要。这是一个关于如何将 Confluence 空间导入 Notion 的实用教程。根据你的需求，你可以通过两种方式将 Confluence 内容导入 Notion。
Zip 文件导入器： 可用于仅导入工作空间的一部分。仅能导入不超过 5GB（或应要求不超过 15GB）的小型工作空间。
API 导入器： 仅能导入整个工作空间。可导入不超过 30GB 的工作空间，并保留评论和用户映射。
多空间导入： 最多可一次性通过 UI 直接导入 10 个 Confluence 空间。每个选定的 Confluence 空间都会生成自己的日志页面，并作为单独的顶级私人页面导入（根据需要导入到不同的 Notion 团队协作区中）。此功能仅适用于 Business 和 Enterprise 方案。
✅ 导入 | ❌ 不导入 |
|---|---|
页面（每次导入最多 5 万个页面） | 权限（导入的页面默认为导入用户的私有页面） |
页面层级 | 大多数宏/插件（许多宏会转换为文本、图片或链接） |
基本格式 | 表格样式 |
内容块 | 私人页面 |
图片 | 自定义表情符号 |
附件 | 图表 |
基本元数据（仅限页面标题） | 预览 |
简易表格（复杂结构可能会降级） | 历史 |
云端和服务器/数据中心实例 | 文件夹 |
评论（仅限 API 导入） | 评论（仅限 ZIP 导入） |
Confluence 站点 → Notion 组织
Confluence 空间 → Notion 工作空间
Confluence 页面 → Notion 页面
宏 → 扁平化内容或最接近的 Notion 块类型（例如，Confluence 展开 → Notion 折叠列表）
导入最多 ~5 万个页面 或 30GB 的内容。更大的导入可能会失败。
提示：对于大型空间，请按子空间或部分拆分导出，并使用 ZIP 导入器。如果工作空间大小超过 100GB，请联系你的帐号管理员。
导入开始后，你可以放心地关闭浏览器——完成后我们会给你发送（电子）邮件。
在
设置→导入中查看你的导入进度。你可以在那里查看导入的状态以及已完成的导入。
使用 .zip 文件导入
将你的 Confluence 空间导出为 HTML
在你的 Confluence 工作空间中，前往右上角侧边栏的
空间设置。在顶部工具栏中选择
内容工具，然后选择导出。如果你没有看到这两个选项，可能需要向工作空间管理员申请导出权限。从格式列表中选择
HTML。选择
自定义导出并取消勾选包含评论复选框。选择你想要导出的页面。请注意，包含大型附件的页面可能会显著增加导出文件的大小和复杂性。
等待导出处理完成。对于大型工作空间，这可能需要一些时间。
完成后，点击
下载将导出文件保存到你的电脑。文件标题类似于Confluence-space-export-XXXXXX.html.zip。
导入 Notion
前往你想要导入 Confluence 内容的 Notion 工作空间。
前往侧边栏中的
设置→导入→第三方导入→Confluence。导航至从 Confluence 导出的
.zip文件并选择上传。你无需解压该文件 — 直接上传整个压缩包即可。浏览器上传文件时，你会看到“正在上传...”消息，随后在导入过程中会看到状态消息。
导入完成后，你将被带到新导入的内容。
使用 Confluence API 导入
连接 Confluence 和 Notion
前往侧边栏中的
设置→导入→Confluence。选择
通过 API 导入。选择你的 Confluence 实例类型：云端 (cloud) 或服务器 (server)。要查找实例类型，请打开 Confluence，点击个人资料旁边的
帮助→?→关于 Confluence。Notion 仅支持云端和服务器实例。
使用 Confluence Cloud 进行身份验证
输入你的 Confluence 电子邮件地址和站点。
从你的 Atlassian 账户创建一个 API 令牌，并将其输入到该字段中。了解更多关于在 Confluence 中创建令牌的信息。
点击
验证。
使用 Confluence Server 进行身份验证
查找并选择你的 Confluence 版本。
输入你的 Confluence 电子邮件地址和站点。
如果你运行的是 Confluence 7.9 或更高版本，请创建一个
个人访问令牌并粘贴它；如果你使用的是早期版本，请输入你的 Confluence 用户名和密码。点击
验证。
导入
从“导入”菜单中点击
Confluence。监控导入进度 — 对于大型空间，此步骤可能需要几个小时。
一旦看到
正在导入页面…，你就可以安全地关闭浏览器窗口。导入完成后，我们会向你发送电子邮件。
如果你想导入多个 Confluence 空间，请重复此部分。
Notion 会将所有内容导入到私人部分的单个根目录/父级中，或者导入到执行导入操作的人员所选的团队协作区中。
建议用户在邀请他人之前先清理并设置好工作空间架构。
必须在 Notion 中重新应用权限——请计划在导入后进行一次检查，将 Confluence 的组和限制映射到 Notion 的群组、团队协作区和页面级权限。
如果 Confluence 表格中包含文件或附件，它将变为 Notion 数据库；否则，它将变为简易表格。
表格样式和宏/插件通常会降级（例如 ui-steps、标注、图片标题）。
大多数宏不受支持。Notion 会尝试将数据映射到最接近的 Notion 块。
由于 Confluence API 不稳定导致的瞬时故障可能会使整个导入过程或某些页面失败。你可能需要重试整个导入。
对于多个空间，请按顺序（一次一个空间）运行导入，除非使用多空间导入（仅限商业版/企业版）。
复杂的 Confluence 数据（例如合并单元格、嵌套表格）可能会导致导入失败。
Notion 仅支持用户范围的 API 令牌（不支持范围令牌）。进行身份验证时，请使用个人 API 令牌选项。
页面中未引用的附件和媒体将不会被导入。
层级结构有时无法完全保留——请通过试点导入进行验证。
LaTeX 数学公式块导入不正确
原因： Confluence LaTeX 插件的块宏格式与行内数学公式不同。Notion 支持行内 LaTeX 宏，但不支持块宏变体。
解决方法： 在重新导入之前，将 Confluence 中的 LaTeX 块宏转换为行内宏，或者将 LaTeX 放入代码区块中，并在导入后手动转换为数学公式块。
无法导入 Gliffy 内容
原因： Notion 的文件导入器不支持 Gliffy 图像。
解决方法： 在导入之前，修改 HTML 以将 Gliffy 块替换为引用正确文件的图像块。
导入失败
为何会发生这种情况： 空间过大、导出格式错误、速率限制或超时。
解决方法： 每次导入一个空间，将大型空间拆分为多个部分，重新导出干净的 ZIP 文件，或使用带有范围运行的 API 导入器。
导入缺少图像或附件
为何会发生这种情况： 资源可能未包含在导出文件中，或 API 令牌无法访问。
解决方法： 确保在导出时选中“包含附件”，保持 ZIP 中的相对路径完整，或在导入后重新上传关键资源。
导入后 Jira 链接预览损坏
为何会发生这种情况： 只有在开始迁移前用户已通过身份验证，Jira 链接预览才能正常工作。
解决方法： 在运行迁移前先通过 Jira 身份验证。
文件层级未按预期保留
为何会发生这种情况： 导出结构中的边缘情况或深度嵌套。
解决方法： 先用具有代表性的子集进行测试；导入 Notion 后再重新组织。
Confluence 宏和/或特殊格式丢失：
为何会发生这种情况： 不支持的宏或应用内容。
解决方法： 映射到 Notion 原生区块：展开 → 折叠/切换，操作项 → 待办事项。简化复杂的表格，或导出为 CSV 并导入 Notion 数据库。
Confluence 权限未在 Notion 中复制：
为何会发生这种情况： 自助导入即会出现此情况。
解决方法： 在内容导入 Notion 后，使用 Notion 群组、团队协作区和页面级权限进行权限映射。
