Docusaurus の評価

実装して得た所感と外部確認可能な事実を分けて記載する。保守状況とリンク先は 2026-07-19 に確認した。

結論

実装した所感

Docusaurus はこの比較の中でも「文書プラットフォーム」として一体化された 初期構成を持つ。Classic テーマ、MDX、自動ナビゲーション、多言語、図、静的 出力が自然につながる。一方、その広さは小規模な Markdown ジェネレーターより 多いビルド機構とクライアント JavaScript を伴う。

確認できる事実

Docusaurus 3.10.2 は現行安定版で、 2026-07-10 に公開された。公式の 3.10 発表 は 3.10 を v3 最後の minor 系列とし、v4 future flags を案内している。このサンプルでは Bun 1.3.14 で core を実行する。これは upstream の Bun 対応保証ではなく、このプロジェクトの build で確認する compatibility result である。

長所

実装した所感

標準テーマはそのままでも実用的で、Infima 変数と React コンポーネントの 差し替えで独自デザインへ進める。自動サイドバーと MDX は中規模以上の文書を 整理しやすい。

確認できる事実

静的生成、MDX、i18n、versioning、ファイルシステム型サイドバー、ダークモード、 公式 Mermaid テーマは Docusaurus の文書化された機能である。このサンプルは versioning 以外を実装する。 Classic テーマ は レスポンシブナビゲーションとページ目次も提供する。

懸念とトレードオフ

実装した所感

設定は明示的だが、site config、sidebar、custom CSS、locale content に分散する。 React/MDX の依存関係を管理し、theme を swizzle した場合は更新時に UI を確認する 必要がある。

確認できる事実

Docusaurus は通常、既定ロケールを URL から省略する。このプロジェクトでは /en/ と /ja/ を明示するため、ロケール別 base URL で2回ビルドする。 オフライン検索は core ではなく @easyops-cn/docusaurus-search-local 0.55.2 である。本文は初期 HTML に含まれるが、検索、React カウンター、Mermaid、 SPA ナビゲーションには JavaScript が必要である。

保守状況 — 2026-07-19

Docusaurus には現行安定版、広い公式文書、明示された v4 移行経路がある。採用した ローカル検索プロジェクトは Docusaurus v2/v3 対応を宣言し、0.55.2 を 2026年5月に 公開した。ただしコミュニティ依存なので、互換性の根拠はこのサイトの英日ビルド 成功であり、Docusaurus 本体の保証ではない。

選定の指針

幅広い統合機能、React/MDX 拡張、多言語、将来の versioned docs が必要なら適する。 依存関係を極小化したい場合や、クライアント拡張を完全に禁止する場合は、より 小さいジェネレーターも比較すべきである。