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.

---

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

大量のコンテンツを 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 に取り込まれます。