Blume

Qu'est-ce que Blume ?

Blume est une plateforme de documentation open source qui transforme du Markdown brut en un site de documentation de qualité production. Conçue pour les équipes qui souhaitent publier une documentation belle, rapide et prête pour l'IA sans écrire ni maintenir de code d'application. Déposez un dossier de fichiers Markdown dans Blume, et il s'occupe du reste — recherche, thèmes, SEO et déploiements en une commande sur Astro et Vite. Gratuit et open source, pour toujours.

À qui cela s'adresse

• Responsables de l'expérience développeur — qui doivent publier et maintenir la documentation de plusieurs produits sans équipe dédiée à l'ingénierie documentaire.
• Équipes API et SDK — qui souhaitent des références interactives et des journaux de modifications générés directement à partir de spécifications OpenAPI et de versions GitHub.
• Mainteneurs de projets open source — qui veulent un site de documentation gratuit, sans configuration, qui reste synchronisé avec leur dépôt et se déploie en une seule commande.

Fonctionnalités clés

Configuration zéro

Un dossier de Markdown constitue un projet complet — aucun modèle à cloner ni gabarit à synchroniser avec l'amont. La navigation est déduite de vos fichiers, et la recherche, les thèmes et les images OG sont activés par défaut. Vous ne touchez à la configuration que lorsque vous en avez réellement besoin.

Références API interactives

Ajoutez une spécification OpenAPI ou AsyncAPI et Blume génère une référence interactive complète — endpoints, schémas et un environnement de test « Essayez » en direct. Propulsé par Scalar et stylé pour correspondre à votre site, vos documents API semblent faire partie du produit, et non une réflexion après coup.

Journal de modifications intégré

Rédigez chaque version comme une entrée Markdown — ou pointez Blume vers vos versions GitHub — et chacune est regroupée dans une chronologie générée à /changelog. Vous obtenez des permaliens, un tri du plus récent au plus ancien et un flux RSS activé par défaut, pour que vos utilisateurs puissent s'abonner à vos mises à jour.

Prêt pour l'IA et i18n inclus

Blume est livré avec une recherche en texte intégral, un mode sombre et la prise en charge de 36 langues (i18n) — le tout sans plugin à installer ni service à configurer. La base prête pour l'IA garantit que votre documentation est structurée de manière à être facilement consommable par les modèles de langage, ce qui devient de plus en plus important à mesure que les assistants IA deviennent une interface principale pour la documentation.

Ce qui se démarque

« Un dossier de Markdown est un projet complet — aucun modèle à cloner, aucun gabarit à synchroniser. »

C'est la promesse centrale, et Blume la tient. La plupart des outils de documentation exigent d'adopter un framework, d'apprendre un système de thèmes ou de configurer une douzaine d'intégrations avant de voir un résultat. Blume inverse cela : l'expérience par défaut est de qualité production, et la configuration est l'exception, non la règle. Combiné aux références API interactives et à l'intégration des versions GitHub, il couvre tout le cycle de vie de la documentation API — du démarrage rapide au journal de modifications — en un seul outil.

À considérer si…

Vous en avez assez de maintenir un site de documentation comme projet secondaire, ou vous êtes sur le point de lancer une nouvelle API et souhaitez une documentation soignée dès le premier jour. Si vous écrivez déjà du Markdown et voulez la recherche, le SEO, l'i18n et la préparation à l'IA sans le code superflu, Blume vaut le détour. C'est particulièrement adapté aux équipes qui publient plusieurs produits ou aux projets open source qui nécessitent une documentation synchronisée avec le code.