GitBookへ移行

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

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

組み込みのインポートツールを使って単一ページまたは複数ページをインポートすることもできます。あるいは Git Sync を使用して Git リポジトリ全体を.

インポートパネルの使用

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

GitBook は Markdown ベースなので、Markdown 形式でコンテンツをインポートすると最良の結果が得られます。現在お使いのツールが Markdown でのエクスポートに対応している場合は、よりスムーズなインポートのためにその形式の使用をおすすめします。

インポートパネル

GitBook のインポートパネル。

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

または、 新規追加 > ページをインポート を 目次の下部で選択するか、ページの アクションメニュー を開いて サブページをインポート.

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

GitBook はさまざまなソースからコンテンツをインポートしますが、製品機能やドキュメント形式の違いにより、インポートされたコンテンツが元のソースと比べて異なる場合があります。

制限事項

GitBook では、現在インポートされたコンテンツに以下の制限があります:

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

GitBook では、これらのインポート制限を引き上げることはできません。より多くのコンテンツを一度にインポートするには、 Git Syncを使用してください。これは最大 5,000 の Markdown ページに対応しています。

---

GitHub または GitLab リポジトリから Git Sync を使用してインポート

大量のコンテンツを GitBook にインポートする場合は、 Git Syncの使用をおすすめします。組み込みの移行ツールでもほとんどのインポートに対応できますが、Git Sync はより大規模な移行を効率的に処理するのに適しています。

以下に、コンテンツをインポートするために必要な基本手順を示します。より詳しい手順と動画デモについては、専用ガイドの Git Sync を使用して GitBook にコンテンツをインポートする.

1

コンテンツを Markdown に変換する

GitBook は Markdown ベースなので、Markdown 形式でコンテンツをインポートすると最良の結果が得られます。現在お使いのツールが Markdown でのエクスポートに対応している場合は、よりスムーズなインポートのためにその形式の使用をおすすめします。

コンテンツがまだ Markdown ファイルになっていない場合は、 Markitdownのようなスクリプトやオンラインツールを使ってコンテンツを変換することをおすすめします。

2

GitHub または GitLab でコンテンツを整理する

GitBook サイトを設定する際は、GitHub または GitLab リポジトリ内でコンテンツを効率的に整理することが重要です。Git Sync はセクション単位で行われるため、コンテンツのグループ化を慎重に計画してください。複数のリポジトリやフォルダーを作成し、必要な Markdown ファイルが正しい場所にあることを確認します。

3

セクションを設定し、Git Sync を構成する

コンテンツを整理するには、必要に応じて GitBook で 1 つ以上のセクションを作成します。 GitHub Sync または GitLab Sync 連携を組織にインストールし、それらのセクション用に設定します。前の手順で設定したフォルダーまたはリポジトリと、セクションを同期する必要があります。

4

Git Sync を GitHub → GitBook の方向で実行する

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

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

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

• Markdown として、Git リポジトリと同期することで。アプリ内に直接 Markdown エクスポートする機能はありません。エクスポートしたいセクションを空の GitHub または GitLab リポジトリと同期し、 Git Syncを使用してください。すると、そのリポジトリが Markdown エクスポートになります。一部のブロックには Markdown 表現がなく、エクスポートでは HTML として表示されます。
• PDF として、ページまたはセクションのアクションメニューから。詳細は PDF エクスポートをご覧ください。非常に大きなセクションをエクスポートする際には制限に達する場合があります。