迁移到 GitBook

如何从 Confluence、Notion、Git 等将现有内容导入到 GitBook

您可以使用导入工具将现有文档迁移并统一到 GitBook 中。

您可以选择使用我们内置的导入工具导入单个或多个页面 —— 或者 使用 Git 同步导入整个 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.

---

单次导入中可上传的最大文件数量（图像等）为

使用 Git 同步从 GitHub 或 GitLab 仓库导入 Git 同步在将大量内容导入 GitBook 时，我们建议使用

虽然我们内置的迁移工具可以处理大多数导入，但 Git 同步更适合高效处理更大规模的迁移。 您可以在下面找到导入内容的基本步骤。有关更详细的步骤和视频演示，请查看我们针对.

1

使用 Git 同步将内容导入 GitBook

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

将您的内容转换为 Markdown 如果您的内容尚未以 Markdown 文件存在，我们建议使用脚本（例如Markitdown

2

）或在线工具将您的内容转换为 Markdown。

在 GitHub 或 GitLab 中组织您的内容

3

在设置您的 GitBook 站点时，务必在 GitHub 或 GitLab 仓库中有效地组织您的内容。由于 Git 同步是在空间级别进行的，请仔细规划如何分组内容。创建多个仓库或文件夹，确保必要的 Markdown 文件位于正确的位置。

设置空间并配置 Git 同步 为组织您的内容，根据需要在 GitBook 中创建一个或多个空间。安装 或 GitHub 同步 GitLab 同步

4

在您的组织中集成并为这些空间配置它。您需要将您的空间与前一步中设置的文件夹或仓库同步。

以 GitHub → GitBook 的方向运行 Git 同步