Blume 开源文档框架：零配置从 Markdown 文件夹生成 AI 就绪文档站点

一句话看懂

Blume 是一个零配置的开源文档框架，从 Markdown 文件夹自动生成带 AI 功能（llms.txt、MCP 服务器）的静态文档站点。

详细发生了什么

OpenAI 开发者 Hayden Bleasel 发布了 Blume 1.0.3，一个 MIT 许可证的开源文档框架。它的核心理念是：把 Markdown 或 MDX 文件放入文件夹，就能得到一个生产级的文档站点，无需编写或维护任何应用样板代码。

Blume 是一个命令行工具加组件库的组合。它读取一个 Markdown/MDX 文件夹，生成一个隐藏的 Astro 项目，最终输出静态 HTML，包含导航、搜索、主题和 Open Graph 图片。配置是可选的，按需添加。

底层原理：CLI 加载 blume.config.ts，扫描内容构建图结构，然后写入一个 .blume/ 目录下的 Astro 项目。Astro 通过一个 catch-all 路由渲染所有页面，每次运行只重写变更文件，保持热更新速度。核心主题不携带客户端框架 JavaScript，因此 Core Web Vitals 默认表现良好。如果需要完全控制，可以用 blume eject 将运行时提升为独立 Astro 应用。

Blume 需要 Node.js 22.12+，支持 Bun、pnpm、npm 或 yarn。它内置了 30 多个 MDX 组件、本地搜索、llms.txt 文件（用于 AI 爬虫）和一个 MCP 服务器（Model Context Protocol），让 AI 工具可以直接读取文档。

中文圈视角

对中文开发者意味着什么？

零配置文档站点的平替：国内常用的文档工具有 VuePress、Docusaurus、Rspress 等，它们都需要配置主题、插件、导航等。Blume 的“零配置”理念更激进——放 Markdown 就出站点，适合快速原型或小型项目文档。但 Blume 目前没有中文社区和插件生态，中文搜索分词可能不如 Rspress（基于 Rust）高效。
AI 就绪特性是亮点：llms.txt 是让 AI 爬虫（如 ChatGPT、Claude）直接抓取文档的标准；MCP 服务器则允许 AI 工具（如 Cursor、Copilot）实时查询文档。这对中文技术团队维护 AI 辅助编程的文档库很有价值——国内类似功能在 Dify、FastGPT 等知识库工具中也有，但 Blume 是直接嵌入文档框架的。
国内使用限制：Blume 依赖 npm 生态和 Astro，国内用户可能需要镜像源。它没有内置 CDN 部署方案，但可以配合 Vercel、Netlify 或国内 Serverless 平台（如阿里云函数计算）使用。
中文文档盲点：目前 Blume 的官方文档是英文，中文教程极少。对于习惯中文文档的开发者，上手门槛略高于 Docusaurus（有中文文档）。但它的 MIT 许可证允许自由修改和二次分发，社区可以贡献中文翻译。

几条值得记住的细节

版本与许可证：Blume 1.0.3，MIT 许可证，完全开源。
运行环境：需要 Node.js 22.12+，支持 Bun、pnpm、npm、yarn。
AI 功能：内置 llms.txt 和 MCP 服务器，让 AI 工具可以直接读取文档。
性能：核心主题无客户端 JS，默认 Core Web Vitals 优秀。
自定义：blume eject 可将隐藏的 Astro 项目转为独立应用，但仍依赖 Blume 包。

一句话总结

如果你需要一个快速、AI 友好的文档站点，Blume 是最简单的选择之一，尤其适合技术团队维护 AI 辅助编程的文档库。