> For the complete documentation index, see [llms.txt](https://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.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>

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

または、 **新規追加** > **ページをインポート** を [目次](/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**.

***

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

GitBook に大量のコンテンツをインポートする場合は、 [Git Sync](/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 %}
**GitHub → GitBook の方向で Git Sync を実行する**

設定手順を進める際は、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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
