Blume, a Zero-Config Markdown-to-Docs Framework, Released as Open Source

Introduction of Blume Framework

Hayden Bleasel has released Blume, a new open-source documentation framework. This framework is designed to render a folder of Markdown files into a complete documentation website without requiring extensive configuration. It is built using Astro and Vite, licensed under MIT, and hosted on GitHub, where it has already garnered over 1,300 stars and reached number seven on GitHub's TypeScript trending list.

Core Functionality and Features

Blume operates on a zero-config principle, where the framework itself acts as the template, eliminating the need for boilerplate code. The command-line interface (CLI) processes a `blume.config.ts` file, scans content into a graph, and generates a hidden Astro project. Prerequisites are minimal, requiring Node.js 22.12 or newer and at least one Markdown file. Configuration is opt-in and type-safe, validated via a schema through `defineConfig`.

AI Readiness and Testing Capabilities

A notable feature of Blume is its AI readiness, with sites emitting `llms.txt` and `llms-full.txt` files and the ability to expose a hosted MCP server. The `blume eval` command transforms documentation into a test suite, where an agent answers user questions using only the documentation, and a judge grades the answers. This allows for continuous integration (CI) to fail if the documentation cannot adequately answer questions.

Migration and Community Feedback

Blume includes a `blume-migrate` skill to translate configurations from other documentation tools like Mintlify, Docusaurus, Fumadocs, Nextra, and Starlight into `blume.config.ts`. It also restructures content, rewrites callouts, and converts icons. Community feedback has led to rapid feature additions, such as query-parameter tabs, addressing requests for improved design system documentation. Reported issues include dark mode flickering and font fallback problems, along with a known Markdown formatting issue inherited from Prettier's Markdown printer.