> 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 への移行

Confluence、Notion、Git などから既存コンテンツを GitBook に取り込む方法

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

組み込みのインポートツールを使用して、1ページまたは複数ページをインポートすることもできます — あるいは [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 Docs

複数ページを **インポートしたい場合**、HTML または Markdown ファイルを含む ZIP ファイルをアップロードするか、 **オンラインドキュメント** インポートオプションを使用できます。

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

### インポートパネル

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F8omDHqTDwNkvdG6Hv81q%2FImport%402x%20(1).png?alt=media&amp;token=a5c0993c-f49a-4911-8297-6e76f0435bcb" alt="A GitBook screenshot showing the import panel"><figcaption><p>GitBook のインポートパネル。</p></figcaption></figure>

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

または、ページやサブページをインポートするには、次を選択します： **新規追加** > **ページをインポート** の下部で [目次](/docs/documentation/ja-gitbook-documentation/rifarensu/gitbook-ui.md#table-of-contents)、または次を開いて **操作メニュー** <picture><source srcset="/files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&amp;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> ページのメニューから次を選択して **サブページをインポート**.

入力元を選択した後、インポートしたいファイルを選択できます。

{% hint style="warning" %}
GitBook はさまざまなソースからコンテンツをインポートできますが、製品機能やドキュメント形式の違いにより、インポートされたコンテンツが元のソースと異なる場合があります。
{% endhint %}

### 制限事項

現在、GitBook のインポートコンテンツには次の制限があります：

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

GitBook ではこれらのインポート上限を引き上げることはできません。より多くのコンテンツを一度にインポートするには、次を使用してください： [Git Sync](/docs/documentation/ja-gitbook-documentation/dokyumentowokdotoshiteu/git-sync.md)、最大 5,000 件の Markdown ページに対応しています。

***

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

大量のコンテンツを GitBook にインポートする場合は、次の方法をおすすめします： [Git Sync](/docs/documentation/ja-gitbook-documentation/dokyumentowokdotoshiteu/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 %}

## コンテンツをエクスポートする

GitBook のコンテンツは 2 通りの方法でエクスポートできます：

* **Markdown として**、Git リポジトリと同期することで行えます。アプリ内に直接 Markdown をエクスポートする機能はありません — エクスポートしたいセクションを、空の GitHub または GitLab リポジトリと次を使って同期してください： [Git Sync](/docs/documentation/ja-gitbook-documentation/dokyumentowokdotoshiteu/git-sync.md)。すると、そのリポジトリが Markdown エクスポート先になります。一部のブロックは Markdown で表現できず、エクスポートでは HTML として表示されます。
* **PDF として**、ページまたはセクションのアクションメニューから行えます。次を参照してください： [PDFエクスポート](/docs/documentation/ja-gitbook-documentation/suru-1/pdf-export.md)。非常に大きなセクションをエクスポートする際は、制限に達する場合があります。


---

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