迁移到 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 文档

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

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

导入面板

GitBook 中的导入面板。

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

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

导入子页面

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

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

限制

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

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

---

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

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

尽管我们的内置迁移工具可以处理大多数导入，但 Git Sync 更适合高效处理较大规模的迁移。 下面列出了导入内容的基本步骤。有关更详细的步骤和视频演示，请前往我们关于.

1

使用 Git Sync 将内容导入 GitBook 的专用指南

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

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

2

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

在 GitHub 或 GitLab 中组织您的内容

3

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

设置空间并配置 Git Sync GitHub 同步 或 为组织安装 GitLab Sync

4

集成并为这些空间进行配置。您需要将您的空间与上一步中设置的文件夹或仓库同步。

以 GitHub → GitBook 的方向运行 Git Sync