For the complete documentation index, see llms.txt. This page is also available as Markdown.

迁移到 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,我们建议使用该格式,以获得更顺畅的导入过程。

导入面板

A GitBook screenshot showing the import panel
GitBook 中的导入面板。

当您创建新分区时,在出现的弹窗中您可以选择导入内容。如果您创建的是空分区,也可以使用 快速开始 新空白页面底部的“分区” 编辑.

或者,您也可以随时通过选择以下选项导入页面或子页面: 新增 > 导入页面 在……的底部 目录,或者打开 操作菜单 The Actions menu icon in 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 同步 或 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。在导出非常大的分区时,您可能会遇到限制。

最后更新于

这有帮助吗?