Docusaurus
Générateur de sites statiques open source pour la documentation, publié par Meta
Docusaurus est un générateur de sites statiques open source de Meta, sous licence MIT, destiné à créer et maintenir des sites de documentation. Une seule commande produit un site fondé sur React qui possède déjà une section de documentation versionnée, un blog, des pages autonomes et un thème, et le dépôt fournit des plugins maintenus pour les sitemaps, la recherche Algolia, les traductions, les redirections et les balises d'analytique. Il compte 65 749 étoiles en juillet 2026. Pour un fondateur qui sort un outil pour développeurs, il supprime le coût de construction d'un site de documentation, ce qui n'est pas la même chose que d'y voir arriver des lecteurs.
Ce qu'est Docusaurus
Docusaurus (github.com/facebook/docusaurus) se décrit comme un projet permettant de construire, déployer et maintenir facilement les sites de projets open source. Dans les faits, c'est un générateur de sites statiques fondé sur React où la documentation est citoyenne de première classe : une commande, npm init docusaurus@latest, produit un site qui possède déjà une section documentation, un blog, des pages autonomes et un thème, si bien que la première journée sert à écrire du contenu plutôt qu'à assembler une pile technique. Meta l'a publié parce qu'il l'aide à tenir l'échelle sur les nombreux projets open source qu'il mène. Le code est sous licence MIT, et le contenu de documentation du dépôt porte une licence Creative Commons distincte.
- Les types de contenu sont des plugins distincts — le dépôt publie des paquets maison séparés pour la documentation, pour un blog et pour des pages autonomes. Un site peut donc être uniquement de la documentation, de la documentation plus un journal des versions, ou un site complet avec page d'accueil marketing, sans introduire un second outil.
- Les pièces qu'on ajoute d'habitude sont déjà là — génération de sitemap, recherche adossée à Algolia, redirections côté client pour les URL déplacées, traductions, prise en charge PWA, diagrammes Mermaid, optimisation d'images et balises Google Analytics existent en paquets maintenus dans le même dépôt.
- Le format d'écriture est MDX — les pages sont du Markdown capable d'embarquer des composants React, ce qui rend possible un bloc de code exécutable ou un exemple interactif à l'intérieur d'une page qui, par ailleurs, n'est qu'un fichier de votre dépôt.
Documentation, blog et page marketing sont trois métiers différents
La manière la plus courante de gâcher un site de documentation est de le traiter comme une surface de contenu de plus et de tout juger au même chiffre. Ces trois surfaces attirent des personnes différentes qui arrivent dans des états différents, et une seule d'entre elles cherche à être trouvée par quelqu'un qui n'a jamais entendu parler de vous.
| Surface | Qui arrive | Ce qu'elle peut et ne peut pas faire |
|---|---|---|
| Documentation | Quelqu'un qui utilise déjà le produit, ou qui vérifie s'il sait faire une chose précise | Lève le doute et débloque la mise en route. Crée rarement de la demande seule, mais c'est là qu'un peut-être devient un oui |
| Blog ou journal des versions | Quelqu'un qui cherche un problème, ou un utilisateur actuel qui regarde ce qui est sorti | Peut gagner de nouveaux visiteurs et donner aux actuels une raison de revenir. Doit exister pour autre chose que des notes de version |
| Page d'accueil marketing | Quelqu'un qui décide s'il doit s'y intéresser du tout | Cadre le produit pour des inconnus. La documentation ne sait pas faire ce travail, et quand elle l'essaie elle se lit comme un manuel |
Docusaurus héberge volontiers les trois, et c'est le piège : parce qu'elles sortent d'un même build, elles sont évaluées comme une seule chose. Séparez d'abord le reporting — une page de documentation et une landing page se ressemblent trait pour trait dans un tableau de trafic alors qu'elles répondent à des questions entièrement différentes. Si la moitié éditoriale est le vrai métier, Ghost est fait pour cela ; si le contenu réclame une interface d'édition pour des gens qui n'ouvrent pas de pull requests, c'est Payload.
Où un site de documentation se place dans la pile de croissance
La documentation est le contenu à plus forte intention que possèdent la plupart des outils pour développeurs, et le plus régulièrement sous-investi. Elle se positionne aussi, sur un type de requête précis : les développeurs cherchent des messages d'erreur, des noms d'API et de fonctions, et des tournures du genre comment fait-on telle chose dans tel outil. Ces requêtes sont peu concurrentielles et très intentionnelles, et une réponse précise les emporte sans l'effort qu'exige un terme générique disputé. C'est une vraie surface d'acquisition, mais étroite, car presque chacune de ces requêtes contient déjà le nom de votre produit ou un problème que votre produit a créé. La documentation amplifie ce que vous avez plutôt que de l'amorcer. Gagner l'attention en amont est traité dans comment faire le marketing d'un outil pour développeurs, et posséder un sujet plutôt qu'une page, c'est l'autorité thématique.
Note de première main issue de la construction d'AgentCeres — l'AI Growth Officer, sur agentceres.com : ce que nous n'avions pas prévu, c'est qu'une page de documentation et une page marketing paraissent identiques dans un rapport d'analytique tout en faisant des métiers opposés. L'une est lue par quelqu'un qui décide ; l'autre par quelqu'un qui a déjà décidé et se retrouve bloqué. Nous ne l'avons remarqué que parce que les questions arrivant dans le chat de notre propre produit correspondaient, presque ligne pour ligne, aux titres que notre documentation aurait dû avoir. Un fil de support se révèle être une meilleure table des matières que n'importe quel outil de mots-clés, parce que c'est la liste des endroits exacts où le produit a cessé d'être évident, classée par fréquence. Si vous installez Docusaurus cette semaine, la page la plus utile à écrire en premier n'est pas la visite des fonctionnalités. C'est la réponse à la question que vous avez déjà tapée trois fois à la main.
FAQ
- Docusaurus est-il gratuit ?
- Le dépôt indique que Docusaurus est sous licence MIT, le contenu de documentation du dépôt relevant d'une licence Creative Commons distincte. Il n'existe pas d'offre payante, puisqu'il produit des fichiers statiques que vous hébergez où vous voulez : le coût est celui de l'hébergement choisi, souvent nul pour un site statique. Vérifiez les fichiers LICENSE de la version que vous installez, car les licences évoluent indépendamment de tout article.
- Docusaurus ou un framework web généraliste ?
- Si le site est surtout de la documentation, l'outil spécialisé l'emporte, parce que le versionnage des docs, les barres latérales, la recherche et une architecture de l'information taillée pour la documentation sont déjà résolus et que vous les rebâtiriez. Si la documentation n'est qu'une section d'un site marketing aux fortes exigences de design, un framework général plus une couche de contenu l'emporte généralement, sinon vous passerez votre temps à lutter contre un thème bâti autour d'un autre centre de gravité. La question est de savoir à quoi le site sert principalement.
- Les sites de documentation aident-ils vraiment au SEO ?
- Ils le peuvent, sur une classe précise de requêtes : messages d'erreur, noms d'API et de fonctions, questions d'intégration et tournures en comment faire qui nomment votre outil. Ces requêtes sont peu disputées et très intentionnelles, et une réponse précise les gagne sans grande autorité de domaine. Ce que la documentation ne peut pas faire, c'est se positionner sur les termes larges de catégorie qui touchent ceux qui n'ont jamais entendu parler de vous. Ce trafic-là se gagne ailleurs.
- Faut-il activer le blog intégré ?
- Seulement si vous vous en servez vraiment. Un journal des versions est un bon réglage par défaut : la matière vient naturellement et il donne aux utilisateurs qui reviennent une raison de le faire. Un blog marketing est un engagement plus lourd qu'il n'y paraît, et un blog abandonné affichant trois billets d'il y a dix-huit mois se lit plus mal que pas de blog du tout. Commencez par le journal des versions et ajoutez le blog quand vous aurez un ensemble précis de questions à traiter.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.