📝 記事サマリー
Blumeは、Markdownファイルをフォルダに置くだけで本格的なドキュメントサイトを構築できるオープンソースツール。AI対応、ゼロコンフィグ、全文検索、SEO、i18n(36言語)などの機能が標準搭載。無料かつオープンソースで、Astroベースで構築されている。
Blumeとは
Blumeは「World-class docs for everything you ship」を掲げるドキュメントサイトジェネレーター。Markdownファーストで、フォルダに.md/.mdxファイルを置くだけでプロダクションレベルのドキュメントサイトが完成する。アプリのボイラープレートを書いたり保守したりする必要がない。
現在v1.0.3が公開されており、パブリックに利用可能。
主な特徴
ゼロコンフィグ設計
- Markdownファイルのフォルダがそのまま完全なプロジェクトになる
- スターターテンプレートのクローンやアップストリーム同期が不要
- ナビゲーションはファイル構造から自動推論
- 検索、テーマ、OG画像がデフォルトで有効
- 必要な時だけコンフィグに手を届ければよい
Batteries Included(標準搭載機能)
プロダクション対応のドキュメントサイトに必要な機能がすべて最初から入っている。プラグインのインストールも外部サービスの設定も不要。
🔍 フルテキスト検索
ローカル検索がdev・本番両方で利用可能。Comet Search(⌘K)のようなコマンドパレット型UI。
🤖 AIレディ
AI対応設計。ドキュメントの内容をAIが活用しやすい構造で出力。
🖼️ OG画像 & SEO
OG画像、サイトマップ、RSS、JSON-LDがデフォルトで有効。SEO対策済み。
🌙 ダークモード
テーマ切り替え対応。ライト/ダーク両モードに完全対応。
🌍 i18n(36言語)
36のロケールに対応。RTL(右から左)言語のサポートも完備。
📊 インタラクティブAPIリファレンス
OpenAPI/AsyncAPIのspecを置くだけで、インタラクティブなAPIリファレンスを自動生成。Scalarベース。
コンポーネントライブラリ
30以上のアクセシブルなコンポーネントとMarkdown拡張が組み込み済み。.mdxページでインポート不要で使用可能。
- Callouts、Cards、Steps、Tabs、File trees
- パッケージインストールタブ、コードグループ
- Mermaidダイアグラム、KaTeX数式
- テーマ対応(theme-aware)で配色自動調整
ビルトイン変更履歴(Changelog)
- 各リリースをMarkdownエントリとして記述、またはGitHub Releasesから自動取得
/changelogページでタイムライン形式で自動生成- パーマリンク付き、新しい順で表示
- RSSフィードもデフォルトで有効
技術スタック
- Astroベース(静的サイトジェネレーター)
- フォント: Inter Tight / Inter / IBM Plex Mono(セルフホスト)
- オープンソース(GitHub: haydenbleasel/blume)
- 無料で永久利用可能
類似ツールとの比較
- vs Docusaurus: Reactベースで重めだが、BlumeはAstroで軽量・ゼロコンフィグ
- vs VitePress: Vueベース。Blumeはより多くのコンポーネントとi18n機能が標準搭載
- vs Mintlify: MintlifyはSaaS型でホスティング込みだが有料プランあり。Blumeは完全無料・OSS
💡 ぶっちゃけ感想
Astroベースでモダンな構成、ゼロコンフィグですぐ立ち上がるのが良い。APIリファレンス自動生成やChangelog機能など、ドキュメントサイトでよく必要になる機能が最初から入っているのが地味に便利。個人プロジェクトから大規模サイトまでスケールする設計。DocusaurusやVitePressからの乗り換え候補として有力。