迁移到 GitBook

了解如何将 Confluence、Notion、Git 等中的现有内容导入 GitBook

你可以使用导入工具在 GitBook 中迁移并整合现有文档。

你可以使用我们内置的导入工具导入单个或多个页面——或者 使用 Git Sync 导入整个 Git 仓库.

使用导入面板

导入面板可以轻松将你的内容从另一个文档网站或现有文件迁移到你的 GitBook 组织中。

当你选择从另一个在线文档网站导入时，只需添加该网站的 URL，GitBook 会处理其余部分。

默认情况下，GitBook 会使用 AI 来简化导入过程。这会智能地优化并清理那些与 GitBook 格式并不完全匹配的导入内容——也就是说，输出会更精致，并且更有效地使用 GitBook 的区块。你可以从菜单中将其关闭。

支持的导入格式

GitBook 支持从文档网站或以下格式的文件导入：

• Markdown（.md 或 .markdown)
• HTML（.html)
• Microsoft Word（.docx)

GitBook 也支持从以下来源导入：

• Confluence
• Notion
• GitHub Wiki
• Quip
• Dropbox Paper
• Google Docs

如果你想 导入多个页面，你可以上传一个包含 HTML 或 Markdown 文件的 ZIP 文件，或者使用 在线文档 导入选项。

GitBook 基于 Markdown，因此以 Markdown 格式导入内容会获得最佳结果。如果你当前的工具支持以 Markdown 导出，我们建议使用该格式，以获得更顺畅的导入过程。

导入面板

GitBook 中的导入面板。

当你创建新的章节时，在弹出的模态窗口中可以选择导入内容。如果你创建的是一个空章节，也可以使用 快速入门 部分，位于新空白页面底部，当你点击 编辑.

或者，你始终可以通过选择以下选项来导入页面或子页面： 添加新 > 导入页面 位于 目录，或者通过打开 操作菜单 某个页面的，并选择 导入子页面.

选择输入来源后，你可以选择要导入的文件。

GitBook 可以从多种来源导入内容，但产品功能和文档格式的差异可能会导致导入内容与原始来源有所不同。

限制

GitBook 目前对导入内容有以下限制：

• 单次导入可上传的最大页面数为 20.
• 单次导入可上传的最大文件数（图片等）为 20.

GitBook 无法提高这些导入限制。若要一次导入更多内容，请使用 Git Sync，它最多支持 5,000 个 Markdown 页面。

---

使用 Git Sync 从 GitHub 或 GitLab 仓库导入

当向 GitBook 导入大量内容时，我们建议使用 Git Sync。虽然我们内置的迁移工具可以处理大多数导入，但 Git Sync 更适合高效处理较大规模的迁移。

你可以在下方找到导入内容的基本步骤。若需更详细的步骤和视频演示，请前往我们专门的指南： 使用 Git Sync 将内容导入 GitBook.

1

将你的内容转换为 Markdown

GitBook 基于 Markdown，因此以 Markdown 格式导入内容会获得最佳结果。如果你当前的工具支持以 Markdown 导出，我们建议使用该格式，以获得更顺畅的导入过程。

如果你的内容还不是 Markdown 文件，我们建议使用脚本（例如 Markitdown）或在线工具来转换你的内容。

2

在 GitHub 或 GitLab 中整理你的内容

在设置 GitBook 站点时，高效地整理 GitHub 或 GitLab 仓库中的内容至关重要。由于 Git Sync 是在章节级别进行同步，请仔细规划如何分组你的内容。可以创建多个仓库或文件夹，并确保所需的 Markdown 文件位于正确的位置。

3

设置章节并配置 Git Sync

为组织你的内容，请根据需要在 GitBook 中创建一个或多个章节。安装 GitHub Sync 或 GitLab Sync 你组织中的集成，并为这些章节进行配置。你需要将该章节与上一步中设置的文件夹或仓库同步。

4

按 GitHub → GitBook 的方向运行 Git Sync

在执行配置流程时，请务必选择 GitHub → GitBook 的方向。这样，你文件夹或仓库中的内容就会从 GitHub 或 GitLab 拉取到 GitBook 中。

导出你的内容

你可以通过两种方式导出 GitBook 内容：

• 作为 Markdown，通过与 Git 仓库同步。应用中没有直接的 Markdown 导出功能——请使用 Git Sync将你想导出的章节与一个空的 GitHub 或 GitLab 仓库同步，该仓库就会成为你的 Markdown 导出。有些区块没有 Markdown 表示形式，在导出中会以 HTML 形式显示。
• 作为 PDF，从页面或章节的操作菜单中。参见 PDF 导出。在导出非常大的章节时，你可能会遇到限制。