2026年にDocusaurusから移行すべきか？意思決定ガイド

このページでは、1つの疑問に答えます。すでにDocusaurusを運用している場合、そのまま使い続けるべきでしょうか？これはカタログではなく、意思決定ガイドです。まだ方針を決めていない場合は、まず2026年のDocusaurusの代替：9つのプラットフォームを比較を読んでください。このページでは、市場全体を評価しています。すでにDocsbookへの移行を決めている場合は、DocusaurusからDocsbookへの移行に進んでください。

簡単に答えると、チーム内の誰かがフロントエンドのビルドを担当するために報酬を受け取っている限り、Docusaurusを使い続けるのは適切です。誰も担当しなくなった時点で、適切な選択ではなくなります。

Docusaurusを使い続けるべきタイミング#

次のいずれかに当てはまる場合は、Docusaurusを使い続けてください。いずれも、所有コストをすでに支払っていることを意味するため、移行しても何も得られません。

• Docusaurusのデプロイが現在問題なく動作しており、次のメジャーバージョンへの移行時期がまだ来ていない。
• ドキュメントページ内にReactコンポーネント（インタラクティブなデモ、カスタムプラグイン、ライブプレイグラウンドなど）を組み込んでいる。
• 誰かの職務記述書に、少なくとも一部としてドキュメントサイトの保守が含まれている。
• ベンダーとの関係を一切持ちたくなく、ホスティングとCIを自社のコストとして負担することを受け入れている。

Reactエコシステム、MDX、そしてswizzleテーマは、実際の強みです。このページのどの記述も、Docusaurusが悪いツールだと主張しているわけではありません。所有者が必要なツールであり、あなたにその所有者がいるのかを問いかけているのです。

Docusaurusから移行すべきタイミングは？#

サイトの所有者がいないにもかかわらず、作業が次々と発生し続けているなら、移行するタイミングです。具体的な兆候は次のとおりです。

• ドキュメントがすでにREADME.mdとdocs/フォルダに置かれていて、それらを置く場所をもう1つ増やしたい人が誰もいない。
• コンテンツに対してAIチャットを使いたいが、検索パイプラインを構築して運用したくない。
• 複数の言語でドキュメントが必要で、ロケールごとに個別にインデックス化する必要があるにもかかわらず、引き継げる翻訳パイプラインがない。
• Nodeのマイナーバージョンが変わると壊れるのがドキュメントサイトであり、それに対応する余裕がある人がいない。
• 設定ファイルではなく、MCPを介してClaude CodeやCursorからドキュメントを管理したい。

Docusaurus スタックを実際に運用するにはいくらかかるのか#

正直に言うと、請求額は小さくても、かかる時間は小さくありません。「Docusaurus は無料」というのはライセンスについてであって、デプロイについてではありません。以下は、自社の数値に照らして見積もるべき項目です。ホスト、トラフィック、給与によって異なるため、ここでは意図的に金額を掲載していません。

決定する前に、この表をご自身の状況に合わせて見積もってください。重要な比較は「無料対サブスクリプション」ではなく、「請求されない時間対請求されるサービス」です。

比較するとDocsbookの料金はいくらですか？#

Docsbookは段階制ではなく、従量課金制です。各プロジェクトにはそれぞれ残高があり、その残高はAIの利用に使われます。サイトの公開、ホスティング、カスタムドメインの提供、読者が開くすべてのページには、残高は一切消費されません。現在の料金はdocsbook.io/pricingで確認できます。このページはリクエストごとに最新の料金定数から生成されます。ブログ記事に掲載した料金は、誰にも通知されないまま古くなってしまうため、このページには料金を記載していません。

移行によって何を失うのでしょうか？#

3つあります。それが、上記の方法を選ぶべき3つの理由です。

• ドキュメントページ内のカスタムReactコンポーネント。 デモを別の場所でホストしてリンクすることはできますが、インラインにはなりません。
• Swizzleレベルのテーマオーバーライド。 カラートークン、フォント、レイアウトの切り替え、ヘッダーとフッターのカスタマイズは利用できますが、任意のコンポーネント置換はできません。
• プラグインシステム。 検索、AI、翻訳、分析機能はプラuggableではなく組み込みになっています。これがトレードオフです。設定する項目が少ない代わりに、変更できる範囲も少なくなります。

移行することで何が得られますか？#

• ビルド手順もCIパイプラインも必要なく、すでにお持ちのGitHubリポジトリからサイトを公開できます。
• 初日から独自のコンテンツについてAIチャットを利用でき、運用する検索パイプラインも必要ありません。
• 15言語に翻訳され、各ロケールごとに個別にインデックス化されます。
• MCPサーバーにより、Claude CodeとCursorがドキュメント設定を直接読み取り、編集できます。
• llms.txtとllms-full.txtが、サイトと各ワークスペース用に自動生成されます。
• ページビュー、読者がアシスタントに尋ねた質問、結果が何も返されなかった検索をレポートする分析機能を利用できます。

ソースファイルがリポジトリの外に出ることはないため、移行は可逆的です。元に戻す際に移行する対象は、すでにGitに保存されています。

実際の移行はどのように進むのでしょうか？#

1. docs/ フォルダーがソースです。Docsbook の参照先を github.com/yourorg/yourrepo に指定します。
2. サイトが docsbook.io/yourorg/yourrepo に表示されます。
3. カスタムドメイン docs.yourcompany.com を接続し、以前の Docusaurus URL をパス単位でリダイレクトします。
4. トラフィックによって同等性が確認されるまで、Docusaurus リポジトリをフォールバックとして保持し、その後削除します。

移行によって検索トラフィックを失うかどうかを決めるのは、ステップ 3 です。Docusaurus から Docsbook への移行で、リダイレクトの完全なチェックリストを確認できます。

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

次のステップ#

• 2026年のDocusaurus代替：9つのプラットフォームを比較 — Docsbookが唯一の候補でない場合の全体像
• DocusaurusからDocsbookへの移行 — リダイレクトを含む手順に沿った移行
• Docs as codeとマネージドプラットフォームの比較 — 請求書ではなく原則として示した同じ意思決定