# 导入内容

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

您可以使用我们内置的导入工具导入单页或多页 —— 或者 [使用 Git Sync 导入整个 Git 仓库](#import-using-git-sync).

## 使用导入面板

### 支持的导入格式

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

* Markdown（`.md` 或 `.markdown`)
* HTML（`.html`)
* Microsoft Word（`.docx`)

我们还支持从以下来源导入：

* Confluence
* Notion
* GitHub Wiki
* Quip
* Dropbox Paper
* Google 文档

如果您想要 **导入多个页面**，您可以上传包含 HTML 或 Markdown 文件的 ZIP 文件。

{% hint style="info" %}
GitBook 基于 Markdown，因此以 Markdown 格式导入内容将获得最佳效果。如果您当前的工具支持导出为 Markdown，我们建议使用该格式以便更顺利地导入。
{% endhint %}

### 导入面板

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQPGDN9Aja68uaLDdZt9M%2Fgetting-started-import-panel.svg?alt=media&#x26;token=bf7114a5-c02c-4dfd-acc5-cf527d68309d" alt="A GitBook screenshot showing the import panel"><figcaption><p>GitBook 中的导入面板。</p></figcaption></figure>

当您创建新空间时，您可以从第一个空页面底部的底板中选择导入内容。

或者，您也可以通过选择来随时导入页面或子页面 **新页面** > **导入新页面** 在 [目录（Table of Contents）](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/zi-yuan/gitbook-ui#table-of-contents)，或打开页面的操作菜单 <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 并选择 **导入子页面**.

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

{% hint style="warning" %}
GitBook 可从各种来源导入内容，但产品功能和文档格式的差异可能导致导入内容与原始来源存在差异。
{% endhint %}

### 限制

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

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

***

## 使用 Git Sync 导入

对于将大量内容导入 GitBook，我们建议使用 [Git 同步](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/zh/ru-men/git-sync)。与我们集成的导入工具不同，Git Sync 更适合高效处理较大规模的迁移。

{% hint style="info" %}
下面为您列出导入内容的基本步骤。有关更详细的步骤和视频演示，请查看我们专门的指南，了解 [使用 Git Sync 将内容导入 GitBook](https://app.gitbook.com/s/LBGJKQic7BQYBXmVSjy0/editing-and-publishing-documentation/import-or-migrate-your-content-to-gitbook-with-git-sync).
{% endhint %}

操作步骤如下：

{% stepper %}
{% step %}

#### 将内容转换为 Markdown

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

如果您的内容尚未以 Markdown 文件存在，我们建议使用脚本（例如 [Markitdown](https://github.com/microsoft/markitdown)）或在线工具将内容转换。
{% endstep %}

{% step %}

#### 在 GitHub 或 GitLab 中组织内容

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

{% step %}

#### 设置空间和 Git Sync

为组织您的内容，根据需要在 GitBook 中创建一个或多个空间。为这些空间在您的组织中安装 [GitHub 同步](https://www.gitbook.com/integrations/github-sync) 或 [GitLab Sync](https://www.gitbook.com/integrations/gitlab-sync) 集成并为其配置。您需要将空间与在前一步设置的文件夹或仓库同步。
{% endstep %}

{% step %}

#### 以 GitHub → GitBook 的方向运行 Git Sync

在遵循配置流程时，请确保选择 GitHub → GitBook 的方向。这样会将文件夹或仓库的内容从 GitHub 或 GitLab 拉取到 GitBook 中。
{% endstep %}
{% endstepper %}
