Blume

Blume 是什么？

Blume 是一个开源文档平台，能将纯 Markdown 转换为生产级文档网站。它专为那些希望快速发布美观、快速且支持 AI 的文档，而无需编写或维护应用样板代码的团队而设计。将 Markdown 文件文件夹放入 Blume，其余工作由它处理——搜索、主题、SEO，以及通过 Astro 和 Vite 的一键部署。永久免费且开源。

适用人群

• 开发者体验负责人——需要在没有专门文档工程团队的情况下，为多个产品发布和维护文档。
• API 和 SDK 团队——希望直接从 OpenAPI 规范和 GitHub Releases 生成交互式参考和变更日志。
• 开源维护者——希望拥有一个零配置、免费的文档网站，与代码仓库保持同步，并能一键部署。

主要功能

零配置设置

一个 Markdown 文件夹就是一个完整项目——无需克隆起始模板，也无需与上游保持同步的模板。导航根据文件自动推断，搜索、主题和 OG 图片默认开启。只有在真正需要时，才需要接触配置。

交互式 API 参考

放入 OpenAPI 或 AsyncAPI 规范，Blume 即可渲染完整的交互式参考——端点、模式以及实时“试用”游乐场。它由 Scalar 驱动，并匹配您的网站主题，让您的 API 文档感觉像是产品的一部分，而非事后补充。

内置变更日志

将每个版本写为 Markdown 条目——或让 Blume 指向您的 GitHub Releases——所有内容都会汇总到 /changelog 的生成时间线中。默认提供永久链接、最新优先排序和 RSS 订阅源，方便用户订阅您的更新。

开箱即用的 AI 就绪和国际化

Blume 自带全文搜索、深色模式，并支持 36 种语言（i18n）——无需安装插件或配置服务。AI 就绪的基础意味着您的文档结构易于语言模型消费，随着 AI 助手成为主要文档界面，这一点越来越重要。

突出亮点

“一个 Markdown 文件夹就是一个完整项目——无需克隆起始模板，也无需保持同步的模板。”

这是核心承诺，Blume 做到了。大多数文档工具要求您采用框架、学习主题系统，或集成十几种服务后才能看到成果。Blume 颠覆了这一点：默认体验即为生产级，配置是例外而非规则。结合交互式 API 参考和 GitHub Releases 集成，它覆盖了 API 文档的完整生命周期——从快速入门到变更日志——一站式解决。

值得关注，如果……

您厌倦了将文档网站作为副项目维护，或者您即将发布新 API，希望文档从第一天起就看起来专业。如果您已经在编写 Markdown，并希望无需样板代码即可获得搜索、SEO、i18n 和 AI 就绪功能，Blume 值得一试。对于发布多个产品或需要文档与代码保持同步的开源项目团队来说，它尤其强大。