GitBookへの移行

Confluence、Notion、Gitなどから既存のコンテンツをGitBookにインポートする方法

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

組み込みのインポートツールを使って単一ページまたは複数ページをインポートするオプションがあります — または 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 ファイルをアップロードするか、 オンラインドキュメント のインポートオプションを使用できます。

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

インポートパネル

GitBook のインポートパネル。

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

または、常にページやサブページをインポートするには、次を選択できます 新規追加 > ページをインポート の下部、または の目次を開いて、 操作メニュー ページのメニューを開き、次を選択します サブページをインポート.

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

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

制限事項

現在、GitBook のインポートコンテンツに関する制限は次の通りです：

• 単一インポートでアップロードできる最大ページ数は 20.

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

---

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

大量のコンテンツを GitBook にインポートする場合は、を使用することを推奨します。 Git 同期組み込みの移行ツールはほとんどのインポートを処理できますが、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 同期 または GitLab Sync の統合をインストールし、それらのスペース向けに設定します。前のステップで設定したフォルダやリポジトリとスペースを同期する必要があります。

4

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

設定プロセスに従う際は、必ず GitHub → GitBook の方向を選択してください。これにより、フォルダやリポジトリの内容が GitHub または GitLab から GitBook に取り込まれます。