迁移到 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 当前对导入内容有以下限制:
单次导入中可上传的最大页面数为 20.
单次导入中可上传的最大文件数(图片等)为 20.
使用 Git Sync 从 GitHub 或 GitLab 仓库导入
当将大量内容导入 GitBook 时,我们建议使用 Git 同步。虽然我们内置的迁移工具可以处理大多数导入,但 Git Sync 更适合高效处理更大规模的迁移。
您可以在下方找到导入内容所需的基本步骤。如需更详细的步骤和视频演示,请前往我们专门的指南,了解 使用 Git Sync 将内容导入 GitBook.
将您的内容转换为 Markdown
GitBook 基于 Markdown,因此以 Markdown 格式导入内容将获得最佳效果。如果您当前的工具支持以 Markdown 导出,我们建议使用该格式以获得更顺畅的导入过程。
如果您的内容还不是 Markdown 文件,我们建议使用脚本(例如 Markitdown)或在线工具来转换您的内容。
在 GitHub 或 GitLab 中整理您的内容
在设置 GitBook 站点时,务必要在您的 GitHub 或 GitLab 仓库中高效地整理内容。由于 Git Sync 是在空间级别进行的,因此请仔细规划如何对内容进行分组。创建多个仓库或文件夹,并确保所需的 Markdown 文件位于正确的位置。
设置空间并配置 Git Sync
要整理您的内容,请根据需要在 GitBook 中创建一个或多个空间。安装 GitHub 同步 或者 GitLab Sync 集成到您的组织中,并为这些空间进行配置。您需要将您的空间与上一步中设置的文件夹或仓库进行同步。
按 GitHub → GitBook 的方向运行 Git Sync
在按照配置流程操作时,请务必选择 GitHub → GitBook 的方向。这样会将您的文件夹或仓库中的内容从 GitHub 或 GitLab 拉取到 GitBook 中。
最后更新于
这有帮助吗?