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 には現在、インポートされたコンテンツに対して次の制限があります:

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

• 1 回のインポートでアップロードできる最大ファイル数（画像など）は 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 Sync または GitLab Sync 統合を組織にインストールし、それらのスペース用に設定します。前の手順で設定したフォルダまたはリポジトリと、スペースを同期する必要があります。

4

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

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