Blume 2.0

Blume 2.0

Hayden Bleasel · Schreiben · Coding

Blume 2.0 ist ein Open-Source-Dokumentationsframework, das aus einem Markdown-Ordner eine schnelle Astro-Seite macht, mit lokaler Suche, API-Referenzen und MCP-Server für Agenten.

Vorschau der Oberfläche von Blume 2.0

Über Blume 2.0

About

Was ist Blume 2.0

Blume 2.0 ist ein Dokumentationsframework auf Basis von Astro und Vite. Sie legen Markdown- oder MDX-Dateien in einen Ordner docs/, führen einen Befehl aus und bekommen eine Seite mit Navigation, Suche, Syntaxhervorhebung und fertigen Open-Graph-Bildern. Es gibt keinen Anwendungscode zu pflegen und kein Dashboard, in das Sie sich morgens einloggen.

Die zweite Hauptversion betrifft vor allem die Konfiguration. Suche, Deployment, Inhaltsquellen, API-Referenzen, Analytics und das Backend des Assistenten sind jetzt Adapter, die Sie aus blume/*-Unterpfaden importieren und in blume.config.ts aufrufen. Die maschinenlesbaren Einstellungen wandern von ai in einen neuen Schlüssel agents. Ihre Seiten bleiben unverändert, deshalb ist das Upgrade Konfigurationsarbeit und keine Neuauflage der Inhalte.

Von anderen statischen Generatoren unterscheidet Blume das zweite Publikum. Jede Seite veröffentlicht llms.txt, eine Markdown-Kopie jeder Unterseite, eine schreibgeschützte JSON-API und optional einen MCP-Server, sodass ein Agent dasselbe liest wie ein Mensch. Genau das macht aus einer Dokumentationsseite in Markdown eine Dokumentation für KI-Agenten. Der Preis dafür ist klar: Blume ist Entwicklerwerkzeug. Wer einen gehosteten Editor mit visueller Vorschau erwartet, landet in einem Git-Repository.

Erste Schritte

  1. Führen Sie npx blume init in einem leeren Ordner aus. Die CLI installiert die Abhängigkeiten und ergänzt die Skripte dev und build in der package.json.
  2. Öffnen Sie blume.config.ts und tragen Sie Seitennamen, URL sowie die Adapter für Suche, Deployment oder Analytics ein, die Sie brauchen.
  3. Legen Sie Ihre Markdown-Dateien in docs/ ab. Die Ordnerstruktur wird zum URL-Pfad, die Reihenfolge der Seiten ergibt sich aus Dateinamen oder einer meta.ts.
  4. Starten Sie npm run dev für die lokale Vorschau und nutzen Sie npm run build für die statische Ausgabe.
  5. Optional: npx blume migrate <Quelle> --codex übergibt eine bestehende Mintlify-, Docusaurus-, GitBook- oder MkDocs-Seite an einen Coding-Agenten.

Produktinformationen

Ein kurzer Überblick über Preise, unterstützte Plattformen und die Leistung von Blume 2.0.

Kostenloser TarifJa
Bezahlte Tarife$0 (MIT license)
PlattformWeb, CLI (Node.js 22.19+)
EntwicklerHayden Bleasel
KategorieSchreiben · Coding
VeröffentlichungsdatumSep 2026
Zuletzt aktualisiertOct 2026
Website-Besuche5.3K
Globales Website-Ranking2.6M
API-VerfügbarkeitNein

Am besten für

Die Nutzer, Aufgaben und Szenarien, für die dieses Tool am besten passt.

Nutzer

  • Entwickler, die ihr eigenes Produkt dokumentieren
  • Plattform- und API-Teams
  • Maintainer von Open-Source-Projekten

Aufgaben

  • Technische Dokumentation aus Markdown veröffentlichen
  • Die Dokumentation für Coding-Agenten lesbar machen
  • Von einer anderen Plattform wechseln

Szenarien

  • Ein Startup wächst über die README hinaus
  • Das Produkt erscheint in mehreren Sprachen
  • Der Support beantwortet jede Woche dieselben Fragen

Wichtigste Funktionen

Markdown-Seiten mit abgeleiteter Navigation

Ordner werden zu Routen, Dateinamen zu Slugs, eine neue Seite ist also eine neue Datei. Die Seitenleiste baut sich aus dem Verzeichnisbaum und nimmt danach Feinheiten aus dem Frontmatter oder einer meta.ts neben den Seiten an. Sie können eine Gruppe umsortieren, mit einem Icon versehen oder eine Seite ausblenden, ohne die Konfigurationsdatei anzufassen, und Breadcrumbs wie Gliederung folgen derselben Struktur.

Agenten-Oberfläche mit llms.txt und MCP

Jede Blume-Seite veröffentlicht llms.txt und eine .md-Kopie pro Route, sodass ein Agent den Quelltext einer Seite lädt, statt gerendertes HTML zu scrapen. Der optionale MCP-Server stellt Suche und Seitenlektüre als Werkzeuge bereit, und die Seite liefert zusätzlich eine JSON-Dokumentations-API, die ein OpenAPI-3.1-Dokument beschreibt. Ein Manifest unter /.well-known/ai-catalog.json lässt Agenten-Register die Seite finden.

API-Referenzen aus der Spezifikation

Blume arbeitet als Generator für API-Referenzen aus OpenAPI-, AsyncAPI- oder GraphQL-Schemas, lokal oder remote. Sie zeigen in der Konfiguration auf die Datei und erhalten eine Übersicht, eine Seite pro Operation, Parameter, Request-Bodys und Antworttabellen. Codebeispiele entstehen in 18 Sprachen, von cURL und Python bis Go, Ruby und C#. Weil die Referenz im Build entsteht, taucht eine Schemaänderung beim nächsten Deployment auf.

Lokale Suche und Assistent auf der Seite

Die Suche läuft ohne API-Schlüssel über einen lokalen Index und findet auch chinesischen, japanischen, koreanischen und thailändischen Text, also Sprachen ohne Wortabstände. Größere Seiten wechseln per Adapter zu Algolia, Typesense, Orama Cloud, Mixedbread oder Pagefind. Das Assistenten-Panel antwortet aus den Seiten der Doku, mit Adaptern für Vercel AI Gateway, OpenRouter, LLM Gateway, Inkeep oder jeden OpenAI-kompatiblen Endpunkt.

Übersetzung und versionierte Dokumentation

Locale-Ordner erzeugen Routen mit Sprachpräfix, Navigation pro Sprache und übersetzte Oberflächentexte, und blume translate füllt fehlende Sprachen auf. Die Versionierung friert pro Release einen Ordner ein, ergänzt einen Versionsumschalter und hält die Suche auf die gewählte Version beschränkt. Beide Funktionen gelten auch für die Agenten-Oberfläche, sodass ein Agent dieselben Routen sieht wie ein Leser.

Prüfung, Audit und Ausstieg nach Astro

blume validate prüft Links, Anker und Frontmatter vor dem Deployment. blume audit liest das gebaute HTML und meldet SEO-Probleme mit Quelldatei und Zeile. blume eval schickt einen Lese-Agenten und einen Richter-Agenten gegen die Doku, um zu testen, ob Antworten wirklich auffindbar sind. Wird das Framework zu eng, verwandelt blume eject das versteckte Projekt in eine eigenständige Astro-App, die Ihnen gehört.

Vor- und Nachteile

Vorteile

  • Die MIT-Lizenz deckt unbegrenzt Editoren, Seiten und Traffic ab, die Kosten bleiben also beim Hosting und bei den Token des Modells, das Sie einsetzen.
  • Start ohne Konfiguration: `npx blume init` liefert eine Seite mit Suche, Navigation und OG-Bildern, bevor Sie eine Zeile Config schreiben.
  • Die Agenten-Oberfläche ist eingebaut und nicht nachträglich angeflanscht, was die Arbeit an `llms.txt` und MCP spart, die heute fast jedes Doku-Team braucht.
  • Die Adapter decken die lästigen Entscheidungen ab, von Algolia und Typesense bis Vercel, Netlify, Cloudflare, PostHog und Plausible.
  • CLI-Prüfungen und `eject` bieten einen Ausweg, die Wahl des Frameworks ist also keine Sackgasse.

Nachteile

  • Blume 2.0 bricht die bisherige Konfiguration. Projekte mit eigener Suche, Deployment, Quellen oder Assistenten müssen diese Blöcke als Adapteraufrufe neu schreiben, bei großer Config kostet das einen Nachmittag.
  • Es gibt keinen gehosteten Editor und kein Dashboard. Redakteure ohne Git-Erfahrung sind auf Entwickler oder eine CMS-Quelle angewiesen, was für Marketingteams echte Kosten bedeutet.
  • Node.js 22.19 oder neuer ist Pflicht, ältere CI-Images scheitern, bis jemand die Laufzeit aktualisiert.
  • KI-Funktionen werden beim Modellanbieter abgerechnet. Das Framework ist kostenlos, ein viel genutzter Assistent oder die Narration erzeugt aber variable Monatskosten.

Häufige Fragen

Blume 2.0 ist die zweite Hauptversion eines Astro-Dokumentationsframeworks mit offener Lizenz. Es erzeugt aus Markdown- oder MDX-Dateien eine Seite und ergänzt Suche, API-Referenzen, Übersetzung, Versionierung und eine Oberfläche, die Agenten lesen können.