迁移到 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 目前对导入内容有以下限制：
单次导入可上传的最大页面数为 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 中。
最后更新于
这有帮助吗？