Суть проекта: Markdown в продакшн без кода
Разработчик из OpenAI Хейден Блэсел (Hayden Bleasel) представил Blume (версия 1.0.3), открытый фреймворк для создания документации. Главная фишка — zero-config: достаточно поместить файлы Markdown или MDX в папку, и инструмент автоматически сгенерирует полноценный сайт. Под капотом работает скрытый проект на Astro и Vite, что обеспечивает высокую производительность. Проект лицензирован под MIT и требует Node.js 22.12+.
Технические детали и сравнение
Blume генерирует статический HTML без клиентского JavaScript в базовой теме, что гарантирует отличные показатели Core Web Vitals. В отличие от Docusaurus (React) или Mintlify (SaaS), Blume предлагает путь «eject» для выноса проекта в самостоятельное Astro-приложение. Ниже приведено сравнение ключевых характеристик:
| Параметр | Blume | Mintlify | Docusaurus | Astro Starlight |
|---|---|---|---|---|
| Тип | Open-source CLI + framework | Hosted commercial | Open-source SSG | Open-source Astro theme |
| Лицензия | MIT, бесплатно | Проприетарная (Pro) | MIT, бесплатно | MIT, бесплатно |
| Движок | Скрытый Astro + Vite | Проприетарный | React | Astro |
| Клиентский JS | Нет (статика) | — | React runtime | Минимальный (islands) |
| AI-интеграция | Встроено (MCP, llms.txt) | Встроено | Плагин сообщества | Не встроено |
AI-Ready: Документация для людей и агентов
Ключевое отличие Blume — нативная поддержка AI. Фреймворк автоматически генерирует файлы llms.txt и llms-full.txt для индексации агентами. Каждая страница доступна в сыром Markdown-формате (через добавление .md к URL). Также встроен сервер Model Context Protocol (MCP), позволяющий таким инструментам, как Claude Code, Cursor и VS Code, читать документацию напрямую через четыре инструмента: search_docs, get_page, list_pages и get_navigation.
Установка и экосистема
Настройка занимает одну команду: npx blume init. Конфигурация пишется на TypeScript (blume.config.ts), что позволяет редакторам ловить ошибки до сборки. Поддерживаются источники из Notion, GitHub Releases и локальных файлов. Уже есть ранние кейсы использования: команда Quiver мигрирует с Mintlify, а Neon использует Blume для документации с MCP.
Почему это важно
Blume решает проблему «разрыва» между документацией для людей и для AI-агентов. Предоставляя готовые инструменты для MCP и AI-запросов «из коробки», он снижает порог входа для разработчиков, желающих сделать свои API и библиотеки доступными для автоматизированных систем. Отсутствие клиентского JS в базовой сборке делает его отличным выбором для проектов, где критична скорость загрузки.
Источник: MarkTechPost ↗