迁移到 GitBook

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

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

您可以选择使用内置导入工具导入单页或多页 — 或者 使用 Git 同步导入整个 Git 仓库.

使用导入面板

导入面板可让您轻松将内容从其他文档网站或现有文件迁移到您的 GitBook 组织中。

当您选择从其他在线文档站点导入时，只需添加该站点的 URL，GitBook 会处理其余部分。

默认情况下，GitBook 使用 AI 来简化导入过程。AI 会智能地优化和清理那些不完全符合 GitBook 格式的导入内容——这意味着输出会更精炼，并更有效地使用 GitBook 的区块。您可以在菜单中禁用此功能。

支持的导入格式

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

• Markdown（.md 或 .markdown)

• HTML（.html)

• Microsoft Word（.docx)

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

• Confluence

• Notion

• GitHub Wiki

• Quip

• Dropbox Paper

• Google 文档

如果您想要 导入多页，您可以上传包含 HTML 或 Markdown 文件的 ZIP 压缩包，或使用 在线文档 导入选项。

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

导入面板

GitBook 中的导入面板。

当您创建新空间时，会在弹出的模态中提供导入内容的选项。如果您创建了一个空空间，也可以使用 快速入门 部分（在您点击新空白页面底部时可见） 编辑.

或者，您也可以始终通过选择来导入页面或子页面 添加新内容 > 导入页面 在页面底部，或通过打开 目录以页面的方式并选择 操作菜单 为页面打开的菜单并选择 导入子页面.

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

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

限制

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

• 单次导入可上传的最大页面数量为 20.

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

---

使用 Git 同步从 GitHub 或 GitLab 仓库导入

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

下面是导入内容的基本步骤。有关更详细的步骤和视频演示，请查看我们关于 使用 Git 同步将内容导入 GitBook 的专门指南.

1

将内容转换为 Markdown

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

如果您的内容尚未以 Markdown 文件形式存在，我们建议使用脚本（例如 Markitdown）或在线工具将内容转换为 Markdown。

2

在 GitHub 或 GitLab 中组织您的内容

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

3

设置空间并配置 Git 同步

为组织内容，按需在 GitBook 中创建一个或多个空间。为这些空间在您的组织中安装 GitHub 同步 或 GitLab 同步 集成并为其配置。您需要将空间与上一步中设置的文件夹或仓库同步。

4

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

在按照配置流程时，确保选择 GitHub → GitBook 的同步方向。这将导致您的文件夹或仓库内容从 GitHub 或 GitLab 拉取到 GitBook 中。