評価
この評価では 実地所感（主観） と、リポジトリまたは公開記録で確認できる 事実を分けています。
実地所感（主観）： Starlight は、この比較で洗練されアクセシブルな Astro ドキュメントサイトへ最短で到達できた選択肢でした。標準機能で大半を 賄え、独自動作には Astro コンポーネントという明確な拡張口があります。
- 事実： i18n ルーティングと翻訳済み UI、Pagefind、ダークモード、 サイドバー自動生成、目次、Expressive Code、静的 HTML 生成を Starlight が 統合しています。
- 事実： MDX から Astro コンポーネントを読み込め、必要な箇所だけに クライアント JavaScript を追加できます。
- 実地所感（主観）： 二言語と GitHub Pages のベースパスを追加しても 設定は小さく保てました。
懸念点とトレードオフ
Section titled “懸念点とトレードオフ”- 事実： GitHub の
[!NOTE]形式は Starlight の標準構文ではありません。 Starlight の Aside は利用できますが、完全に同じ記法にはプラグインか変換が 必要です。 - 事実： Mermaid と LaTeX の両方が標準で揃うわけではありません。この
サンプルでは
mermaid、remark-math、rehype-katex、KaTeX を追加しました。 - 実地所感（主観）： 小さな CSS 変更は容易ですが、構造変更では コンポーネント override と Astro のモデルを理解する必要があります。
メンテナンス状況 — 2026-07-19
Section titled “メンテナンス状況 — 2026-07-19”事実： このサンプルは 2026-07-17 公開の
astro@7.1.1 と、
2026-07-03 公開の
@astrojs/starlight@0.41.3
を導入しています。Starlight リポジトリ
とリリース履歴には継続的な活動があります。ただし公開活動から将来の人員や
リリース頻度までは保証できません。
Astro のコンテンツ中心の静的出力、強い標準機能、必要箇所だけの対話性が合う 場合に Starlight を選びます。GitHub Alerts の完全互換、Mermaid などが必須なら 統合作業を見込み、深いテーマ変更は事前に試作すると安全です。