# Blume

> Open-source, markdown-first documentation powered by Astro and Vite.

## Changelog

- [blume@1.3.1](https://useblume.dev/changelog/blume-1-3-1)
- [blume@1.3.0](https://useblume.dev/changelog/blume-1-3-0)
- [blume@1.2.1](https://useblume.dev/changelog/blume-1-2-1)
- [blume@1.2.0](https://useblume.dev/changelog/blume-1-2-0)
- [blume@1.1.4](https://useblume.dev/changelog/blume-1-1-4)
- [blume@1.1.3](https://useblume.dev/changelog/blume-1-1-3)
- [blume@1.1.2](https://useblume.dev/changelog/blume-1-1-2)
- [blume@1.1.1](https://useblume.dev/changelog/blume-1-1-1)
- [blume@1.1.0](https://useblume.dev/changelog/blume-1-1-0)
- [blume@1.0.4](https://useblume.dev/changelog/blume-1-0-4)
- [blume@1.0.3](https://useblume.dev/changelog/blume-1-0-3)
- [blume@1.0.2](https://useblume.dev/changelog/blume-1-0-2)
- [blume@1.0.1](https://useblume.dev/changelog/blume-1-0-1)
- [blume@1.0.0](https://useblume.dev/changelog/blume-1-0-0)

## Docs

- [Introduction](https://useblume.dev/docs): Blume is an open-source, markdown-first documentation framework on Astro and Vite — fast, AI-ready, and zero-config down to the template.
- [Quickstart](https://useblume.dev/docs/quickstart): Install Blume, scaffold a new project, and ship your first documentation page in minutes — then grow it into a full site at your own pace.
- [Deployment](https://useblume.dev/docs/deployment): Deploy static docs to any host with zero configuration, or switch to server-side rendering with an adapter when you need dynamic behavior.
- [FAQ](https://useblume.dev/docs/faq): Common questions about Blume — how it compares to other documentation tools, and why a Markdown formatter might collapse your callout directives.

### Content

- [Pages](https://useblume.dev/docs/content): How the files in your content folder become pages, and how to organize and name them so routing and navigation are inferred automatically.
- [Navigation](https://useblume.dev/docs/content/navigation): Blume builds the sidebar from your files, then lets you refine it with frontmatter, folder meta, or config — breadcrumbs and outlines follow along.
- [Folder meta](https://useblume.dev/docs/content/meta): Configure a sidebar group with a meta.ts file beside its pages — set the group's title, icon, order, and the order of the pages nested inside.
- [Syntax](https://useblume.dev/docs/content/syntax): Every Markdown and MDX feature Blume renders — formatting, lists, tables, callouts, code blocks, package installs, and math.
- [Components](https://useblume.dev/docs/content/components): Cards, steps, tabs, accordions, badges, code groups, frames, trees, type tables, live previews, and diffs — the built-in components, usable in any MDX page.
- [Islands](https://useblume.dev/docs/content/islands): Drop an interactive component into islands/ and use it in any MDX page — hydrated automatically, no per-page import.
- [Content sources](https://useblume.dev/docs/content/sources): Pull docs from local files, a remote repository, or any custom backend — and mix several sources into one static-first site read at build time.
- [Internationalization](https://useblume.dev/docs/content/i18n): Serve your docs in multiple languages with locale-aware routing, per-language navigation, translated UI, and SEO — all convention-first.

### Configuration

- [Configuration file](https://useblume.dev/docs/configuration): Every option in blume.config.ts, from site metadata and content sources to the links that lead into each individual feature configuration guide.
- [Theming](https://useblume.dev/docs/configuration/theming): Tune the look with a handful of config tokens, override any CSS variable in theme.css, or drop down to Tailwind utilities for custom components.
- [Customization](https://useblume.dev/docs/configuration/customization): Override components, add interactive islands, mount custom pages, install registry components, or eject entirely when you need full control.
- [Search](https://useblume.dev/docs/configuration/search): Client-side search that works out of the box with no API keys, plus optional hosted and semantic backends you can switch to as your docs grow.
- [AI](https://useblume.dev/docs/configuration/ai): Make your docs machine-readable with llms.txt, add an optional in-page Ask AI assistant, and expose a hosted MCP server for coding agents.
- [Analytics](https://useblume.dev/docs/configuration/analytics): First-party web analytics — Vercel Web Analytics, PostHog, or any custom script — wired up from blume.config.ts.
- [Export](https://useblume.dev/docs/configuration/export): Let readers download any page as a PDF or EPUB — rendered client-side, so your static builds stay static and need no server infrastructure.
- [SEO](https://useblume.dev/docs/configuration/seo): Metadata, Open Graph images, RSS feeds, and JSON-LD — Blume's discoverability layer, grouped under one seo config.

### Advanced

- [Skills](https://useblume.dev/docs/advanced/skills): The agent skills Blume ships — playbooks that teach a coding agent like Claude Code, Codex, or Cursor to build and maintain a Blume docs site.
- [Custom Pages](https://useblume.dev/docs/advanced/custom-pages): Mount fully custom .astro routes alongside your docs and read your site's config, navigation, and content from the blume:data module.
- [Changelog](https://useblume.dev/docs/advanced/changelog): Author release notes as ordinary content files or source them from GitHub Releases, and Blume builds a timeline page and an RSS feed automatically.
- [Blog](https://useblume.dev/docs/advanced/blog): Publish posts as content, get an RSS feed and article structured data for free, and build a custom index page.
- [OpenAPI / AsyncAPI](https://useblume.dev/docs/advanced/api-reference): Drop in an OpenAPI spec and get a native API reference — one real page per operation, in your sidebar and search.

### Reference

- [Frontmatter](https://useblume.dev/docs/reference/frontmatter): Every frontmatter field a page accepts, all optional — title, description, sidebar, SEO, search, and the rest, with what each one controls.
- [CLI](https://useblume.dev/docs/reference/cli): Every Blume command and flag explained in one place — init, dev, build, preview, add, sync, and eject — along with the options each one accepts.
- [Evals](https://useblume.dev/docs/reference/eval): blume eval gives your docs a test suite — an AI agent answers your users' questions using only the documentation, a judge grades the answers, and CI fails when the docs can't answer.

## RSS Feeds

- [Blume — Changelog](https://useblume.dev/changelog/rss.xml)