# GitBook へ移行する

インポートツールを使用して、GitBook 内の既存ドキュメントを移行し、統合できます。

組み込みのインポートツールを使って単一ページまたは複数ページをインポートできます。あるいは [Git Sync を使用して Git リポジトリ全体をインポートできます](#import-using-git-sync).

## インポートパネルの使用

インポートパネルを使うと、別のドキュメントサイトや既存ファイルからコンテンツを 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 ファイルをアップロードするか、 **オンラインドキュメント** のインポートオプションを使用できます。

{% hint style="info" %}
GitBook は Markdown ベースなので、Markdown 形式でコンテンツをインポートすると最良の結果が得られます。現在お使いのツールで Markdown へのエクスポートが可能な場合は、よりスムーズなインポートのためにその形式の使用をおすすめします。
{% endhint %}

### インポートパネル

<figure><img src="/files/abe518d533723e90a3131a5c1ea3a3dba567ae43" alt="A GitBook screenshot showing the import panel"><figcaption><p>GitBook のインポートパネル。</p></figcaption></figure>

新しいスペースを作成すると、表示されるモーダルでコンテンツをインポートするオプションがあります。空のスペースを作成した場合は、 **クイックスタート** をクリックしたときに表示される新しい空白ページ下部のセクションからもインポートできます。 **編集**.

または、 **新規追加** > **ページをインポート** を [目次](/docs/documentation/ja-gitbook-documentation/rissu/gitbook-ui.md#table-of-contents)の下部で選択するか、ページの **アクションメニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="/files/3489a3405c2f5c8e7f31c02ff44e42d2e3e8dbf6" alt="The Actions menu icon in GitBook"></picture> を開いて **サブページをインポート**.

を選ぶことで、いつでもページまたはサブページをインポートできます。

{% hint style="warning" %}
入力元を選択した後、インポートしたいファイルを選択できます。
{% endhint %}

### 制限事項

GitBook には現在、インポートされたコンテンツに対して次の制限があります:

* 1 回のインポートでアップロードできる最大ページ数は **20**.
* 1 回のインポートでアップロードできる最大ファイル数（画像など）は **20**.

***

## Git Sync を使用して GitHub または GitLab のリポジトリからインポートする <a href="#import-using-git-sync" id="import-using-git-sync"></a>

大量のコンテンツを GitBook にインポートする場合は、 [Git 同期](/docs/documentation/ja-gitbook-documentation/getting-started/git-sync.md)の使用をおすすめします。組み込みの移行ツールでほとんどのインポートは処理できますが、Git Sync の方が大規模な移行をより効率的に扱うのに適しています。

{% hint style="info" %}
コンテンツをインポートするための基本手順は以下のとおりです。より詳しい手順と動画デモについては、専用ガイドの [Git Sync を使用して GitBook にコンテンツをインポートする](/docs/guides/editing-and-publishing-documentation/import-or-migrate-your-content-to-gitbook-with-git-sync.md).
{% 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 で 1 つ以上のスペースを作成します。 [GitHub Sync](https://www.gitbook.com/integrations/github-sync) または [GitLab Sync](https://www.gitbook.com/integrations/gitlab-sync) 統合を組織にインストールし、それらのスペース用に設定します。前の手順で設定したフォルダまたはリポジトリと、スペースを同期する必要があります。
{% endstep %}

{% step %}
**Git Sync を GitHub → GitBook の方向で実行する**

設定プロセスを進める際は、GitHub → GitBook の方向を選択していることを確認してください。これにより、フォルダまたはリポジトリの内容が GitHub または GitLab から GitBook に取り込まれます。
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/import.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
