> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/getting-started/import.md).

# 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>

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

また、いつでもページまたはサブページをインポートすることができます。 **新規追加** > **ページをインポート** の下部にある [目次](/url/gitbook.com/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" %}
GitBook はさまざまなソースからコンテンツをインポートしますが、製品機能や文書形式の違いにより、元のソースと比べてインポートされたコンテンツに差異が生じる場合があります。
{% endhint %}

### 制限事項

GitBook には現在、インポート済みコンテンツに対して以下の制限があります:

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

***

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

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

{% hint style="info" %}
コンテンツをインポートするための基本手順は以下で確認できます。より詳細な手順と動画デモについては、専用ガイドの [Git Sync を使用して GitBook にコンテンツをインポートする方法](/url/gitbook.com/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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-open-v2-preview.gitbook.workers.dev/url/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.