Blume の紹介：Markdown フォルダから AI 対応ドキュメントを自動生成するオープンソース・ゼロ設定フレームワーク
OpenAI の開発者である Hayden Bleasel 氏が、Markdown ファイルを配置するだけで AI 対応のドキュメントサイトを構築できるオープンソースツール「Blume」をリリースした。
キーポイント
ゼロ構成でのドキュメント生成
Markdown フォルダにファイルを置くだけで、ナビゲーション、検索、テーマ設定を含む本番環境向けのドキュメントサイトが即座に構築される。
Astro ベースの高性能アーキテクチャ
内部で非表示の Astro プロジェクトを動的に生成・管理し、クライアントサイド JavaScript を排除して Core Web Vitals のスコアを最大化する。
柔軟な設定とエジェクト機能
TypeScript による型安全な設定ファイルでカスタマイズが可能であり、必要に応じて完全な Astro アプリとしてエジェクト（分離）できる。
AI エージェント対応設計
.md サフィックスや llms.txt により AI アジェンツが直接コンテンツを読み取り、MCP サーバー機能で Claude Code や VS Code がドキュメントを直接参照可能。
多様なユースケースと統合
OpenAPI/AsyncAPI 仕様の自動レンダリングや GitHub リリースからの変更履歴生成、36 カ国語対応など、API ドキュメントからグローバルなドキュメントサイトまで幅広くサポート。
ゼロ構成と静的パフォーマンス
Markdown フォルダを配置するだけで設定不要で起動し、コアクライアント JS を含まない完全静的 HTML として出力されるため、Core Web Vitals に優れる。
ゼロ構成とロックイン回避
Markdown フォルダから設定不要でドキュメントサイトを構築でき、必要に応じてスタンドアロンの Astro アプリとしてエジェクト可能で長期のベンダーロックインを防止します。
影響分析・編集コメントを表示
影響分析
このツールは、ドキュメント作成の複雑さを劇的に削減し、特に AI プロジェクトのように技術文書が重要な分野において、迅速かつ高品質なナレッジベースの構築を可能にする。Astro を活用した軽量設計により、SEO やパフォーマンス面でも優れた成果をもたらすため、開発者コミュニティにおけるドキュメント標準の再定義につながる可能性がある。
編集コメント
OpenAI のエンジニアが主導するこのプロジェクトは、ドキュメント作成の「ゼロ構成」体験を確立し、技術文書の品質と開発効率を同時に向上させる画期的なツールです。
OpenAI の熟練開発者、ヘイデン・ブレスル氏が「Blume」というオープンソースのドキュメントフレームワークを公開しました。リリース当日にはすでに npm へバージョン 1.0.3 として配信されています。
使い方は極めてシンプルです。Markdown ファイルをフォルダに放り込むだけで、ドキュメントサイトが完成します。その後はアプリの骨組み（ボイラープレート）を書いたり維持したりする必要はありません。プロジェクトは MIT ライセンスでオープンソース化されています。
Blume とは何なのか？
Blume は、ドキュメント作成用のコンポーネントライブラリを備えたコマンドラインツールです。Markdown または MDX ファイルが格納されたフォルダを読み込み、そこから本番環境で使えるレベルのドキュメントサイトを生成します。
生成されるサイトには、ナビゲーション機能、検索機能、テーマ切り替え、そして Open Graph 画像が含まれています。設定は任意であり、必要なファイルから順に追加していく形式です。
コードベースは TypeScript のモノレポ構成で、公開パッケージは packages/blume に配置されています。興味深いことに、Blume 自身のドキュメント（apps/docs）も、実は Blume 自身を使って構築されています。
動作には Node.js 22.12 以降が必要です。Bun、pnpm、npm、yarn のいずれのランタイムでも実行可能です。
Blume はどのように動くのか？
Blume の内部では、非表示の Astro プロジェクトが生成・実行されています。まず CLI が blume.config.ts を読み込み、コンテンツをグラフ構造として取り込みます。その後、Astro プロジェクトが .blume/ ディレクトリ内に書き出されます。Astro は単一のワイルドカードルートを通じて全ページをレンダリングします。このルートでは、Blume が提供するコンポーネント、生成されたデータ、そしてユーザーのオーバーライドを読み込みます。
実行するたびに .blume/ 内のファイルが再生成され、変更があったもののみが書き換えられます。そのため、編集中はホットリロードも高速に動作します。コアテーマにはクライアントサイドの JavaScript フレームワークが含まれていないため、デフォルトで Core Web Vitals のスコアも良好です。
必要に応じて完全な制御権を得たい場合は、blume eject コマンドでランタイムをスタンドアロンの Astro アプリとして抽出できます。ただし、抽出されたプロジェクトでも blume パッケージへの依存は維持されます。
(function(){
var f=document.getElementById("blume-explainer-frame");
window.addEventListener("message",function(e){
if(e&&e.data&&e.data.type==="blume-explainer-height"&&e.data.height){
f.style.height=e.data.height+"px";
}
});
})();
Getting Started
セットアップは単一のコマンドで完了するため、導入もスムーズです。
npx blume initその後、blume dev でホットリロード付きのサーバーが起動します。一方、blume build を実行すると、静的な HTML とローカル検索インデックスが dist/ ディレクトリに書き出されます。
設定ファイルは実際の TypeScript 記述で、スキーマによって検証されています。
// blume.config.ts
import { defineConfig } from "blume";export default defineConfig({
content: {
sources: [
{ type: "filesystem", root: "docs" },
{ type: "notion", database: process.env.NOTION_DB },
],
},
});
設定ファイルは型定義されているため、ビルドを実行する前にエディタがミスを検出してくれます。CLI はこれらの基本機能に加え、プロジェクトのライフサイクル全体をカバーしています。
コマンド | 目的
---|---
blume init | プロジェクトのスキャフォールディング（デフォルトは対話式）
blume dev | ホットリロード付きの開発サーバー起動
blume build | スタティックサイトまたはサーバーサイドサイトのビルド
blume add | レジストリからソースコンポーネントをインストール
blume sync | リモートコンテンツソースの再取得
blume eject | ランタイムをスタンドアロンの Astro アプリとして昇格
blume validate | 内部リンク、アンカー、アセット、外部リンクのチェック
blume doctor | 設定とコンテンツの問題診断
AI を意識した設計
人間による読者だけでなく、Blume は AI エージェントも対象としています。URL の末尾に .md を付加すると、すべてのページが生の Markdown として返されます。単一のフラグで、エージェント向けの llms.txt と llms-full.txt が生成されます。各ページは Markdown としてコピーしたり、ChatGPT、Claude、v0 で直接開いたりできます。
オプションの「Ask AI」アシスタントがページ内で質問に即座に回答します。これは Vercel AI Gateway、OpenRouter、Inkeep、または OpenAI 互換のエンドポイントを通じて動作する AI SDK を利用しています。Blume はまた、Model Context Protocol (MCP) サーバーもホスト可能です。これにより、Claude Code、Cursor、VS Code がドキュメントを直接読み込むことができます。
claude mcp add --transport http your-docs https://docs.example.com/mcpこのサーバーは、読み取り専用の 4 つのツールを公開しています。具体的には search_docs（ドキュメント検索）、get_page（ページ取得）、list_pages（ページ一覧）、そして get_navigation（ナビゲーション取得）です。
具体的なユースケースと例
これらの機能は、実際の業務タスクに直結しています。API プロダクトの場合、OpenAPI または AsyncAPI の仕様書をフォルダに配置するだけで、Blume が自動的にインタラクティブなリファレンスページを生成します。スキーマや認証情報、そして Scalar を活用したリクエスト実行環境もすぐに利用可能です。
ライブラリのドキュメント作成では、GitHub Releases へのパスを指定するだけです。各リリースは自動的に集約され、RSS フィード付きの生成された変更履歴タイムラインとして表示されます。グローバルなユーザー層を対象とする場合は、ロケール（地域）ごとの翻訳ファイルを追加すれば OK。Blume は 36 のロケールをサポートしており、ロケールに応じたルーティングや右から左へのレイアウト対応も標準で備えています。
コンテンツが混在するケースでも問題ありません。ローカルファイルに、リモートの MDX、Notion、あるいは Sanity のデータを組み合わせることも可能です。どのソースからも同じコンポーネントを通じてレンダリングされるため、一貫したデザインを維持できます。
Blume の紹介
あらゆるプロダクトのドキュメント作成に最適な、世界クラスのフレームワークです。Markdown ファイルをフォルダに放り込むだけで、アプリの骨組み（ボイラープレート）を書く手間もゼロで、完全なドキュメントサイトが完成します。
→ 設定不要のセットアップ
→ SEO と AEO の自動最適化
→ 30 種類以上のコンポーネント
→ Astro と Vite をベースに高速動作
→ オープンソースで永久無料
pic.twitter.com/fQSwLd9BM9
— Hayden Bleasel (@haydenbleasel) July 13, 2026
Blume の比較
文脈を理解してもらうため、Blume を一般的なドキュメント作成の 3 つのアプローチと比較します。機能は急速に進化するため、採用する際は最新の詳細情報を必ずご確認ください。
| 項目 | Blume | Mintlify | Docusaurus | Astro Starlight |
|---|---|---|---|---|
| 種類 | オープンソース CLI + フレームワーク | クラウド型商用プラットフォーム | オープンソース SSG（静的サイトジェネレーター） | オープンソースの Astro テーマ |
| ライセンス | MIT（無料） | 専用ライセンス；Pro 版は有料 | MIT（無料） | MIT（無料） |
セットアップ
ゼロ構成の Markdown フォルダから、設定駆動型の管理環境を構築します。Scaffold と React 設定、Astro プロジェクトとテーマが用意されています。
エンジン
裏側では Astro と Vite が動作し、Proprietary なホスト環境で React を使用しています。コアとなるテーマクライアントの JS は不要（静的 HTML）、または最小限のランタイム（アイランド）のみです。
機能比較
llms.txt / llms-full.txt の生成は、Blume ではビルトインフラグで対応し、Auto-generated で自動生成されます。一方、他プラットフォームではコミュニティプラグインが必要です。Built-in MCP サーバーも Blume は標準搭載（4 つの読み取り専用ツール）ですが、他は非対応です。
脱出経路
Blume ではスタンドアロンの Astro アプリとしてエジェクト可能で、ロックインを回避できます。他プラットフォームではこの機能は適用されません。
強みと弱み
強み
- ゼロ構成での開始: Markdown フォルダ一つで完全なサイトが構築されます。
- 静的ファースト出力: コアとなるクライアント JS を含まないため、Core Web Vitals の向上に寄与します。
- 内蔵 AI 機能: llms.txt、ページごとの Markdown、MCP サーバー、Ask AI などが標準で提供されます。
- 型安全な設定: エディタがビルド実行前にエラーを検知できます。
- 脱出経路の確保: スタンドアロンの Astro アプリとしてエジェクトできるため、長期的なベンダーロックインを回避できます。
弱み
- バージョン 1.0.3 は新機能: エコシステムはまだ発展途上です。
- Node.js の要件: Node.js 22.12 以降が必要です。一部の環境では対応していません。
- サーバーアダプタの必要性: Ask AI や MCP などのリクエスト時機能は、サーバーアダプタを必要とします。
- セルフホストモデル: アナリティクスやアシスタントの連携は、ユーザー自身が管理する必要があります。
- 統合数の制限: 成熟したホスト型プラットフォームに比べ、サードパーティ製との連携はまだ少ないです。
まとめ
Blume は、ゼロ構成で Markdown フォルダを本番用のドキュメントサイトに変換します。裏側では Astro と Vite を駆使し、必要に応じてスタンドアロンの Astro アプリとして展開可能です。AI 機能も llms.txt、ページごとの Markdown、MCP サーバーなど標準で搭載されています。
ライセンスは MIT で、Node.js 22.12 以上が必要です。リリース当日にはすでに npm v1.0.3 が公開されています。
初期採用者には、Mintlify から移行した Quiver や、Neon の add-mcp ドキュメントが含まれています。
GitHub リポジトリもぜひご覧ください。Twitter ではフォローを、ML サブレッド（登録者数 15 万人以上）への参加やニュースレターの購読もお忘れなく。あ、Telegram も使っていますか？今なら Telegram でも私たちに参加できますよ。
GitHub リポジトリや Hugging Face ページ、製品リリース、ウェビナーなどのプロモーションを当社と連携して行いたい場合は、ぜひご連絡ください。
本記事「Meet Blume: An Open-Source, Zero-Config Documentation Framework That Ships AI-Ready Docs From a Markdown Folder」は、MarkTechPost で最初に公開されました。
原文を表示
Hayden Bleasel, an expert developer from OpenAI, released Blume, an open-source documentation framework. Blume shipped to npm as version 1.0.3 the same day. It is as simple as Drop Markdown into a folder and ship a docs site. No app boilerplate is written or maintained afterward. The project is MIT-licensed and open sourced.
What is Blume?
Blume is a command-line tool paired with a component library for docs. It reads a folder of Markdown or MDX files. From that folder, it produces a production-grade documentation site. That output ships navigation, search, theming, and Open Graph images. Configuration stays optional and is added one file at a time. The code is a TypeScript monorepo; the published package sits at packages/blume. Blume’s own documentation, under apps/docs, is built with Blume itself. It requires Node.js 22.12 or newer. It runs with Bun, pnpm, npm, or yarn.
How Blume Works?
Under the surface, Blume generates and drives a hidden Astro project. First, the CLI loads blume.config.ts and scans your content into a graph. Next, it writes an Astro project into a .blume/ directory. Astro then renders every page through a single catch-all route. That route imports Blume’s shipped components, the generated data, and your overrides. On each run, .blume/ regenerates, and only changed files are rewritten. As a result, hot reload stays fast during editing. The core theme ships no client framework JavaScript. Consequently, pages score well on Core Web Vitals by default. When you need full control, blume eject promotes the runtime into a standalone Astro app. That ejected project still depends on the blume package.
(function(){
var f=document.getElementById("blume-explainer-frame");
window.addEventListener("message",function(e){
if(e&&e.data&&e.data.type==="blume-explainer-height"&&e.data.height){
f.style.height=e.data.height+"px";
}
});
})();
Getting Started
Setup takes a single command, so onboarding is short.
Copy CodeCopiedUse a different Browser
npx blume init
Afterward, blume dev starts a hot-reloading server. Meanwhile, blume build writes static HTML and a local search index into dist/. The config file is real TypeScript, validated by a schema.
Copy CodeCopiedUse a different Browser
// blume.config.ts
import { defineConfig } from "blume";
export default defineConfig({
content: {
sources: [
{ type: "filesystem", root: "docs" },
{ type: "notion", database: process.env.NOTION_DB },
],
},
});
Because the config is typed, editors catch mistakes before a build runs. The CLI covers the full lifecycle beyond those basics:
CommandPurpose
blume initScaffold a project, interactive by default
blume devStart the dev server with hot reload
blume buildBuild the static or server site
blume addInstall a source component from the registry
blume syncRe-fetch remote content sources
blume ejectPromote the runtime into a standalone Astro app
blume validateCheck internal, anchor, asset, and external links
blume doctorDiagnose config and content problems
AI-Ready by Design
Beyond human readers, Blume targets agents too. Every page returns raw Markdown when you append .md to its URL. A single flag emits llms.txt and llms-full.txt for agents. Each page can be copied as Markdown or opened in ChatGPT, Claude, or v0. An optional in-page Ask AI assistant answers reader questions directly. It runs on the AI SDK through the Vercel AI Gateway, OpenRouter, Inkeep, or any OpenAI-compatible endpoint. Blume can also host a Model Context Protocol (MCP) server. Through it, Claude Code, Cursor, and VS Code read docs directly.
Copy CodeCopiedUse a different Browser
claude mcp add --transport http your-docs https://docs.example.com/mcp
That server exposes four read-only tools: search_docs, get_page, list_pages, and get_navigation.
Use Cases With Examples
Those capabilities map to concrete jobs. For an API product, drop in an OpenAPI or AsyncAPI spec. Blume then renders an interactive reference with schemas, auth, and a request playground via Scalar. For a library, point Blume at your GitHub Releases. Each release rolls up into a generated changelog timeline with an RSS feed. For a global audience, add translated files per locale. Blume supports 36 locales, locale-aware routing, and right-to-left layouts. For mixed content, combine local files with remote MDX, Notion, or Sanity. All sources render through the same components.
Introducing Blume image
A world-class docs framework for everything you ship. Drop Markdown into a folder and ship a full docs site with no app boilerplate.
→ zero-config setup
→ automatic SEO and AEO
→ 30+ components
→ powered by astro + vite
→ open source, free forever pic.twitter.com/fQSwLd9BM9
— Hayden Bleasel (@haydenbleasel) July 13, 2026
How Blume Compares
For context, here is Blume against three common documentation approaches. Features change quickly, so verify current details before you adopt.
DimensionBlumeMintlifyDocusaurusAstro Starlight
TypeOpen-source CLI + frameworkHosted commercial platformOpen-source SSGOpen-source Astro theme
LicenseMIT, freeProprietary; paid Pro tierMIT, freeMIT, free
SetupZero-config Markdown folderConfig-driven, managedScaffold + React configAstro project + theme
EngineHidden Astro + ViteProprietary hostedReactAstro
Core-theme client JSNone (static HTML)—React runtimeMinimal (islands)
llms.txt / llms-full.txtBuilt-in flagAuto-generatedCommunity pluginCommunity plugin
Built-in MCP serverYes (four read-only tools)Yes (auto-hosted)Not built-inNot built-in
Eject pathStandalone Astro appNot applicable (hosted)—Already Astro
Strengths and Weaknesses
Strengths
Zero-config start: a folder of Markdown becomes a full site.
Static-first output ships no core client JS, aiding Core Web Vitals.
Built-in AI surfaces: llms.txt, per-page Markdown, MCP server, and Ask AI.
Type-safe config, so editors flag errors before a build runs.
Eject path to a standalone Astro app reduces long-term lock-in.
Weaknesses
Version 1.0.3 is new, so the ecosystem is still young.
It needs Node.js 22.12 or newer, which some environments lack.
Request-time features like Ask AI and MCP need a server adapter.
The self-hosted model means you own analytics and assistant wiring.
It has fewer third-party integrations than mature hosted platforms today.
Key Takeaways
Blume turns a Markdown folder into a production docs site with zero config.
It drives a hidden Astro and Vite project and can eject to standalone Astro.
AI features ship built in: llms.txt, per-page Markdown, and an MCP server.
It is MIT-licensed, needs Node.js 22.12+, and reached npm v1.0.3 on launch day.
Early adopters include Quiver, moving from Mintlify, and Neon’s add-mcp docs.
Check out the GitHub Repo. Also, feel free to follow us on Twitter and don’t forget to join our 150k+ML SubReddit and Subscribe to our Newsletter. Wait! are you on telegram? now you can join us on telegram as well.
Need to partner with us for promoting your GitHub Repo OR Hugging Face Page OR Product Release OR Webinar etc.? Connect with us
The post Meet Blume: An Open-Source, Zero-Config Documentation Framework That Ships AI-Ready Docs From a Markdown Folder appeared first on MarkTechPost.
関連記事
今日のまとめ
AI日報で今日の重要ニュースをまとめ読み