C'EST QUOI ?
Docusaurus est un générateur de sites statiques pensé pour la documentation technique, maintenu par Meta. On écrit le contenu en Markdown ou MDX, on personnalise le thème React, et le résultat est un site rapide, indexable et déployable en un seul dossier statique. Très utilisé par les projets open source pour leur portail de docs.
POURQUOI C'EST INTÉRESSANT ?
- MDX natif : Le Markdown est étendu avec des composants React inline. Pratique pour des callouts, des onglets de code, des démos interactives directement dans la prose.
- Versioning intégré : Docusaurus gère plusieurs versions de la documentation simultanément (v2.0, v3.0, etc.) sans configuration tierce. Indispensable pour les libs qui maintiennent des branches actives.
- i18n out of the box : Système de traductions en local ou via Crowdin, avec routes par langue. Pas besoin de plugin compliqué.
- Recherche et blog inclus : Algolia DocSearch est branchable en quelques lignes, et le blog intégré couvre les release notes ou changelogs sans empiler un autre outil.
- Architecture pluggable : Plugins, presets, thèmes swizzlables. On peut customiser un composant sans forker, et la communauté maintient des plugins pour OpenAPI, redirects, sitemaps, etc.
CAS D'USAGE
- Portail de documentation pour une librairie open source ou une API publique
- Site de docs interne d'entreprise avec versioning par release
- Knowledge base technique multilingue
- Blog d'ingénierie + docs sous le même toit, avec recherche unifiée
- Documentation produit avec démos React/MDX interactives