Blume 2.0

Blume 2.0

Hayden Bleasel · ライティング · コーディング

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

Blume 2.0 の画面プレビュー

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 リポジトリが待っている。

はじめかた

  1. 空のフォルダで npx blume init を実行する。CLI が依存関係を入れ、package.json に dev と build を追加する。
  2. blume.config.ts を開き、サイト名、URL、必要な検索・デプロイ・分析のアダプターを書く。
  3. Markdown ファイルを docs/ に置く。フォルダ構成が URL のパスになり、ページ順はファイル名か meta.ts で決まる。
  4. npm run dev でローカル確認、npm run build で静的ファイルを出力する。
  5. 任意で npx blume migrate <移行元> --codex を使うと、Mintlify、Docusaurus、GitBook、MkDocs の既存サイトの変換をコーディングエージェントに渡せる。

AIツール情報

Blume 2.0の料金、対応プラットフォーム、性能を簡単に確認できます。

無料プランはい
有料プラン$0 (MIT license)
プラットフォームWeb, CLI (Node.js 22.19+)
開発元Hayden Bleasel
カテゴリライティング · コーディング
リリース日Sep 2026
最終更新Oct 2026
サイト訪問数5.3K
サイト世界ランキング2.6M
API提供状況いいえ

こんな人におすすめ

このツールが最も力を発揮するユーザー、タスク、シーン。

ユーザー

  • 自社プロダクトのドキュメントを書く開発者
  • プラットフォームチームと 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 リファレンス、翻訳、バージョン管理、エージェントが読める面を足す。