GitBookからDocsbookへの移行：ステップごとのガイド

GitBookのユーザーごとの料金の増加が、ドキュメント自体の増加よりも速くなったと感じたことはありませんか。あるいはAIアドオンの価格に悩んでいるかもしれません。または、検索インデックスに適切に登録されないドキュメントサイトに、年間料金を支払っていることに気づいたかもしれません。これは実践的な移行ガイドです。

ほとんどのチームは3時間以内に完了しています。最も手間がかかるのはリダイレクトです。

要約#

GitBook のコンテンツを Markdown としてエクスポートする
新しい GitHub リポジトリにプッシュする
Docsbook をそのリポジトリに接続する（5 秒）
docsbook.io/yourorg/yourrepo でサイトを確認する
カスタムドメイン docs.yourcompany.com を Docsbook に接続する
以前の GitBook パスからのリダイレクトを設定する
サイト全体の内部リンクを更新する

ステップ1：GitBookからエクスポート#

GitBookでは、ワークスペースの設定からマークダウン形式でエクスポートできます：

GitBookスペースを開く
設定 → Gitと同期 → 「GitBookをGitプロバイダーと同期」
GitHubを選択し、新しいプライベートまたはパブリックリポジトリを選択する
GitBookがフロントマター付きのマークダウンとしてコンテンツを同期する

代替方法（Git Syncを使用しない場合）：スペースメニューから「マークダウンにエクスポート」オプションを使用し、結果をローカルで解凍します。

GitBookがエクスポートするフォルダー構造：

README.md
SUMMARY.md
docs/
  introduction.md
  guides/
    quick-start.md
  api/
    auth.md

ステップ2：Docsbookの規約に合わせる#

対応すべき小さな違いが2つあります：

SUMMARY.md は Docsbook では任意です#

GitBook は SUMMARY.md をナビゲーションソースとして使用します。Docsbook はフォルダー構造とフロントマター title からナビゲーションを自動的に構築します。

SUMMARY.md を保持することも（Docsbook は無視します）、削除することもできます。ほとんどのチームは削除します。

フロントマター#

GitBook のフロントマター:

---
description: How to authenticate
---

Docsbook は同じ description フィールドと、オプションの title を読み取ります。title がない場合は、最初の H1 が使用されます。

簡単な移行スクリプト:

find . -name "*.md" -not -path "./.git/*" -exec \
  sed -i.bak '1,/^---$/ s/^description:/description:/' {} \;

（ほとんどの場合、変更は必要ありません — GitBook と Docsbook のフロントマターには互換性があります。）

ステップ3：Docsbookに接続#

docsbook.ioにアクセス
GitHubでサインイン
github.com/yourorg/yourrepoを貼り付け
5秒でdocsbook.io/yourorg/yourrepoにサイトが公開されます

リポジトリにdocs/フォルダーがある場合、Docsbookはそれを使用します。ドキュメントがルートにある場合も機能します。

ステップ4：カスタムドメイン#

Docsbookは自動SSL付きでdocs.yourcompany.comを提供します。

Docsbookダッシュボードで：

設定 → ドメイン
docs.yourcompany.comを入力
DNSを更新：CNAME docs → cname.vercel-dns.com
SSLは自動的に無料で提供されます

ステップ5：リダイレクト#

SEOに関係する唯一のステップです。GitBookのURLは次のようになります：

docs.yourcompany.com/v/1.0/api/authentication

DocsbookのURL：

docs.yourcompany.com/api/authentication

2つの選択肢があります：

オプション A: DNS/CDN レベルでリダイレクト#

ドメインの前段に Cloudflare がある場合は、ページルールを追加します:

docs.yourcompany.com/v/*/api/* → docs.yourcompany.com/api/$2 [301]

オプション B：Docsbook 経由でリダイレクト#

リポジトリのルートに _redirects ファイルを追加します（スタックが対応している場合）：

/v/1.0/api/auth /api/auth 301
/v/1.0/api/webhooks /api/webhooks 301

301 は SEO の評価を保持します。302 では保持されないため、301 を使用してください。

ステップ6：内部参照を更新する#

コードベース全体で検索と置換を行います：

grep -rl "docs.yourcompany.com/v/" . | xargs sed -i.bak 's|docs.yourcompany.com/v/[0-9.]*/|docs.yourcompany.com/|g'

更新対象：

製品アプリのフッターリンク
マーケティングサイト
GitHub上のREADMEリンク
サポートチームの保存済み返信

ステップ 7: AI サーフェスを確認する#

Docsbook は llms.txt、llms-full.txt、JSON-LD、サイトマップを自動的に生成します。次を確認してください:

curl https://docs.yourcompany.com/llms.txt | head -20
curl https://docs.yourcompany.com/sitemap.xml | head -10

期待される内容については、llms.txt: 完全ガイドをご覧ください。

改善される点#

	GitBook	Docsbook
料金モデル	サイト単位、および共同作業ユーザーごとの料金（gitbook.com/pricing、2026-09-03に確認）	プロジェクトごとの従量課金残高で、AIの利用に応じて消費（docsbook.io/pricing、リアルタイム生成）
AIチャット	追加オプション	組み込み
AI翻訳	利用不可	15言語
MCPサーバー	利用不可	組み込み
llms.txt	手動	自動
信頼できる唯一の情報源	GitBook DB	あなたのGitHubリポジトリ

壊れる可能性があるもの#

GitBook 固有のブロック — 折りたたみ可能なセクション、ヒントブロック、タブ。Docsbook は標準の Markdown と Docsbook 固有のブロックをサポートしています。GitBook のヒントのほとんどは、> [!NOTE] のコールアウトにきれいに書き換えられます。
カスタム OpenAPI 統合 — GitBook には API リファレンスレンダラーがあります。Docsbook は既存のツールを介して OpenAPI をレンダリングするか、外部リンクを使用します。
GitBook AI チャット履歴 — 引き継がれません。新しいコンテンツでチャットが新しく開始されます。

所要時間#

私たちがチームの移行を支援してきた経験では：

個人創業者、約50ページ：1時間
小規模スタートアップ、約200ページ：3時間
成長中の企業、約1000ページ、カスタムドメイン：半日

時間がかかるのは、社内でURLの変更を周知し、サポートツールに保存されている返信を更新する作業です。

無料で始める — クレジットカード不要

次のステップ#

GitBook と Docsbook の比較 — この移行の背景となる機能ごとの比較
ドキュメント用のカスタムドメイン — ステップ 4 の DNS と SSL に関する部分
ドキュメント SEO ガイド — URL 変更後も検索順位を維持する方法