
Blume 2.0
Hayden Bleasel · ライティング · コーディング
Blume 2.0 はオープンソースのドキュメントフレームワークだ。Markdown フォルダを高速な Astro サイトに変え、ローカル検索、API リファレンス、コーディングエージェント向けの MCP サーバーを載せる。

Blume 2.0 について
About
Blume 2.0 とは
Blume 2.0 は Astro と Vite の上に作られたドキュメントフレームワークだ。Markdown か MDX のファイルを docs/ フォルダに入れ、コマンドを1回叩けば、ナビゲーション、検索、シンタックスハイライト、Open Graph 画像まで揃ったサイトが出てくる。アプリのコードを保守する必要も、毎朝ダッシュボードにログインする必要もない。
2つ目のメジャーバージョンが変えたのは主に設定だ。検索、デプロイ、コンテンツソース、API リファレンス、分析、アシスタントのバックエンドは、blume/* のサブパスから読み込んで blume.config.ts で呼ぶアダプターになった。機械可読の設定は ai から新しい agents キーへ移った。ページ側は触らなくていいので、アップグレードは設定の作業であって書き直しではない。
他の静的サイトジェネレーターとの違いは2人目の読者にある。すべてのサイトが llms.txt、ページごとの Markdown ミラー、読み取り専用の JSON ドキュメント API を出力し、任意で MCP サーバーも立てられる。エージェントは人間と同じ内容を読める。この一式があるからこそ、ただの Markdown ドキュメントサイトが AI エージェント向けドキュメントになる。代わりに受け入れる条件もはっきりしている。開発者向けツールであり、ホスト型エディタと WYSIWYG パネルを期待すると Git リポジトリが待っている。
はじめかた
- 空のフォルダで
npx blume initを実行する。CLI が依存関係を入れ、package.jsonにdevとbuildを追加する。 blume.config.tsを開き、サイト名、URL、必要な検索・デプロイ・分析のアダプターを書く。- Markdown ファイルを
docs/に置く。フォルダ構成が URL のパスになり、ページ順はファイル名かmeta.tsで決まる。 npm run devでローカル確認、npm run buildで静的ファイルを出力する。- 任意で
npx blume migrate <移行元> --codexを使うと、Mintlify、Docusaurus、GitBook、MkDocs の既存サイトの変換をコーディングエージェントに渡せる。
AIツール情報
Blume 2.0の料金、対応プラットフォーム、性能を簡単に確認できます。
こんな人におすすめ
このツールが最も力を発揮するユーザー、タスク、シーン。
ユーザー
- 自社プロダクトのドキュメントを書く開発者
- プラットフォームチームと API チーム
- オープンソースプロジェクトのメンテナー
タスク
- Markdown から技術ドキュメントを公開する
- コーディングエージェントに読ませる
- 別プラットフォームからの移行
シーン
- スタートアップで README が足りなくなった
- 製品を複数言語で出す
- サポートが毎週同じ質問に答えている
主な機能
Markdown ページと自動で組まれるナビゲーション
フォルダがルートになり、ファイル名が slug になる。新しいページは新しいファイルだ。サイドバーはディレクトリツリーから自動で組み上がり、そのあと frontmatter やページ横の meta.ts で調整できる。グループの並べ替え、アイコン指定、ページの非表示は設定ファイルを触らずに済み、パンくずと右側の目次も同じ構造に従う。
llms.txt と MCP を備えたエージェント向けの面
Blume のサイトは llms.txt とルートごとの .md ミラーを公開する。エージェントは描画済み HTML をスクレイピングせず、ページの元テキストを取れる。任意の MCP サーバーは検索とページ読み取りをツールとして出し、サイトは OpenAPI 3.1 で記述した JSON ドキュメント API も配信する。/.well-known/ai-catalog.json のマニフェストがあれば、エージェントのレジストリからサイトを見つけられる。
仕様から作る API リファレンス
Blume は API リファレンス生成ツールとして動く。OpenAPI、AsyncAPI、GraphQL のスキーマをローカルでもリモートでも指定できる。設定を仕様ファイルに向ければ、概要、操作ごとのページ、パラメータ、リクエストボディ、レスポンス表が揃う。コードサンプルは cURL、Python から Go、Ruby、C# まで18言語に対応する。リファレンスはビルド時に作られるので、スキーマの変更は次のデプロイに出る。
ローカル検索とページ内アシスタント
検索はローカルインデックスで動き、API キーが要らない。単語を空白で区切らない中国語、日本語、韓国語、タイ語も拾う。サイトが大きくなったら、アダプターで Algolia、Typesense、Orama Cloud、Mixedbread、Pagefind に乗り換えられる。アシスタントパネルはサイト自身のページから回答し、Vercel AI Gateway、OpenRouter、LLM Gateway、Inkeep、OpenAI 互換の任意のエンドポイントに対応する。
翻訳とバージョン管理されたドキュメント
ロケールフォルダは言語プレフィックス付きのルート、言語別ナビゲーション、翻訳済みの UI 文言を生み、blume translate が足りない言語を埋める。バージョン機能はリリースごとにスナップショットのフォルダを凍結し、切り替え UI を足し、検索を選択中のバージョンに限定する。どちらもエージェント向けの面に効くので、エージェントは読者と同じルートを見る。
検査、監査、Astro への退出
blume validate は公開前にリンク、アンカー、frontmatter を検査する。blume audit はビルド後の HTML を読み、SEO の問題を元ファイルと行番号付きで報告する。blume eval は読み手エージェントと審査エージェントをドキュメントに当て、答えが本当に見つかるかを試す。フレームワークが窮屈になったら、blume eject で隠れたプロジェクトを自分で持つ Astro アプリに変えられる。
メリットとデメリット
メリット
- MIT ライセンスで編集者、ページ、トラフィックが無制限。費用はホスティングと、自分で選んだモデルのトークンだけになる。
- 設定なしで始められる。`npx blume init` は config を1行も書く前に、検索、ナビゲーション、OG 画像付きのサイトを出す。
- エージェント向けの面が後付けではなく標準搭載で、今ほとんどのドキュメントチームが抱える `llms.txt` と MCP の作業を省ける。
- アダプターが面倒な選択を吸収する。Algolia、Typesense から Vercel、Netlify、Cloudflare、PostHog、Plausible まで揃う。
- CLI の検査と `eject` という出口があるので、フレームワークの選択が囲い込みにならない。
デメリット
- Blume 2.0 は設定の破壊的変更を含む。検索、デプロイ、ソース、アシスタントを設定していたプロジェクトは、そのブロックをアダプター呼び出しに書き換える必要があり、大きな config だと半日かかる。
- ホスト型のエディタもダッシュボードもない。Git に慣れていない書き手は開発者か CMS のソースに頼ることになり、マーケティングチームには実費になる。
- Node.js 22.19 以上が必須で、古い CI イメージは実行環境を上げるまで通らない。
- AI 機能の料金はモデル提供者に直接かかる。フレームワークは無料でも、アシスタントの利用が多いサイトやナレーション生成は毎月の変動費になる。
よくある質問
Blume 2.0 は Astro 向けのオープンソースのドキュメントフレームワークの2つ目のメジャーバージョンだ。Markdown か MDX からサイトを作り、検索、API リファレンス、翻訳、バージョン管理、エージェントが読める面を足す。
関連コンテンツ
Blume 2.0に関連するツール、スキル、記事を探す。
Blume 2.0の代替ツール
Google EmbeddingGemma 2
Google DeepMind · ライティング · 画像 · コーディングGoogle EmbeddingGemma 2 は 7 億 4000 万パラメータのオープンなモデルで、テキスト、コード、画像、音声、動画フレームを同じ 768 次元空間のベクトルに変え、スマートフォンやノート PC 上で動く。

MePersona
MePersona, Inc. · ライティング · 生産性向上 · マーケティングMePersonaはクリエイター向けのAI統合受信箱だ。あなたの話し方を学習し、12プラットフォームに届くファンメッセージの返信を下書きして、承認したものだけを送る。
Fluence
Yay Software (Yannick Huchard) · ライティング · 音声・言語 · 生産性向上Fluence は Android 向けのドキュメントリーダーだ。PDF、EPUB、Word 文書、ウェブ記事を読み上げ、発話中の文を画面で追わせ、本文についての質問にも端末上で答える。
