En résumé
MDX combine la simplicité de Markdown avec la puissance des composants React dans un seul fichier. Onyx l'utilise nativement pour le blog : écriture rapide, composants interactifs intégrables, rendu statique ultra-rapide. Le format est devenu le standard de la documentation technique moderne.
MDX : la convergence de Markdown et React
Depuis son introduction, MDX a transformé la façon dont les développeurs
écrivent du contenu. Le principe est simple : dans un fichier .mdx,
vous pouvez utiliser des composants React exactement comme en JSX.
Pourquoi MDX gagne
Trois raisons expliquent l'adoption croissante de MDX :
1. La richesse du contenu interactif
Un article MDX peut contenir un démo live, un quiz, une visualisation de données. C'est impossible avec du Markdown classique, lourd avec un CMS traditionnel.
2. Le workflow Git-based
Les fichiers MDX vivent dans votre repository Git. Reviews par PR, historique des changements, rollbacks instantanés. Votre documentation suit le même workflow que votre code.
3. La performance
Contrairement aux CMS headless qui nécessitent des appels API au runtime, MDX est compilé à la build. Le résultat est du HTML statique, optimisé, sans dépendance au réseau.
Onyx utilise next-mdx-remote avec remark-gfm pour le rendu.
Le parsing se fait côté serveur, le bundle client reste minimal.
Ce que ça change pour la documentation
La documentation est souvent le parent pauvre des projets web. Avec MDX :
- Les mises à jour sont des PRs comme les autres
- Le SEO est natif et automatique
- Les exemples de code peuvent être interactifs
- Le design est cohérent avec le reste du produit
Onyx part de ce constat et construit une plateforme qui transforme ce workflow en expérience fluide, déployable en quelques minutes.
L'avenir : MDX et les LLMs
Les moteurs de recherche génératifs (SGE, Perplexity, ChatGPT) indexent de plus en plus le web. La documentation bien structurée en MDX, avec du JSON-LD et des métadonnées riches, est mieux comprise et mieux citée par ces systèmes.
Onyx est conçu pour cette réalité : votre documentation est optimisée à la fois pour les humains et pour les machines.
