Blume: marco de documentación sin configuración que convierte un folder de Markdown en un sitio web listo para IA
Blume, lanzado por Hayden Bleasel, transforma cualquier carpeta de Markdown en un sitio de documentación completo con SEO, AEO y componentes listos, todo sin necesidad de configurar un proyecto base.
Blume llega con cero configuración
Hayden Bleasel ha puesto en GitHub Blume, un framework de documentación que convierte una carpeta de Markdown en un sitio web funcional sin que el usuario tenga que escribir código de aplicación. El proyecto, construido sobre Astro y Vite, se publica bajo la licencia MIT y ya cuenta con más de 1 300 estrellas, ocupando la séptima posición en la lista de tendencias de TypeScript de GitHub.
La idea central es que el framework sea un “template” completo: no hay que clonar un repositorio base, solo ejecutar un CLI. El comando npx blume init crea la estructura mínima, lee blume.config.ts, construye un grafo de contenido y genera un proyecto Astro oculto bajo .blume/. Los únicos requisitos son Node.js 22.12+ y un archivo Markdown.
Configuración y generación
La configuración es opcional y totalmente tipada. Un ejemplo típico es:
import { defineConfig } from "blume";
export default defineConfig({
title: "Acme Docs",
deployment: { site: "https://docs.example.com" },
});
Blume expone archivos llms.txt y llms-full.txt, sirve el Markdown sin procesar a cualquier URL .md y puede publicar un servidor MCP. Además, blume eval transforma la documentación en una suite de pruebas: un agente responde preguntas usando solo la documentación, un juez califica las respuestas y el CI falla si la documentación no cubre la pregunta.
Compatibilidad y migración
El changelog incluye una habilidad blume-migrate que convierte configuraciones de Mintlify, Docusaurus, Fumadocs, Nextra y Starlight a blume.config.ts. Se reorganiza el contenido en una navegación basada en el sistema de archivos, se crean redirecciones para rutas movidas, se convierten los callouts a directivas ::: y los iconos a Lucide.
Algunos usuarios han reportado problemas menores: el modo oscuro presenta parpadeo al navegar por el cliente y la fuente vietnamita falla el fallback. Bleasel respondió rápidamente añadiendo pestañas basadas en parámetros de consulta en un día, aunque sigue sin ofrecer URLs indexadas por pestaña.
Competencia y posicionamiento
Blume se posiciona como la alternativa de código abierto a plataformas como Mintlify (servicio cerrado) y a bibliotecas como Docusaurus o Nextra que requieren scaffolding y mantenimiento de un runtime React. Ofrece un tema central sin JavaScript de cliente, con posibilidades de override y un comando blume eject que convierte el runtime generado en una aplicación Astro independiente.
El proyecto alcanzó el segundo lugar en Product Hunt el día de su lanzamiento, con 304 votos, y fue cubierto por MarkTechPost en julio.
¿Qué significa “AI‑ready”?
Bleasel explicó que “AI‑ready” implica la generación de llms.txt, la entrega de Markdown sin procesar a través de encabezados de negociación, servidores MCP, la legibilidad por agentes y habilidades adicionales. El objetivo es que la documentación sea fácilmente consumible por modelos de lenguaje.
¿Por qué importa?
Para los equipos que mantienen documentación técnica, Blume ofrece una forma rápida de publicar contenido sin lidiar con la configuración de herramientas complejas. Su enfoque minimalista, la ausencia de JavaScript del lado del cliente y la compatibilidad con flujos de trabajo de CI/CD lo hacen atractivo para infraestructuras donde el rendimiento y la simplicidad son prioritarios.
