Pourquoi j'ai choisi MDX pour mon blog technique
Retour d'expérience sur le choix de MDX pour un blog développeur intégré à Next.js App Router : avantages, setup et bonnes pratiques.
Le besoin
En tant que développeur, j'avais besoin d'un espace pour partager mes articles techniques originaux, séparé de ma page de curation (veilles technologiques). Le blog devait s'intégrer naturellement dans mon portfolio Next.js existant.
Pourquoi MDX ?
MDX combine le meilleur de deux mondes :
- Markdown pour l'écriture rapide et structurée
- JSX pour intégrer des composants React interactifs
Contrairement à un CMS headless, les fichiers MDX vivent dans le repo Git. Pas de dépendance externe, pas de base de données, pas de latence API. C'est du contenu as code.
L'architecture
La stack est simple :
gray-matterpour parser le frontmatter YAMLnext-mdx-remote/rscpour le rendu côté serveur avec React Server Components- Les fichiers
.mdxdans/content/blog/
Chaque article a un frontmatter standardisé :
title: "Mon article"
description: "Description pour le SEO"
date: "2026-02-28"
tags: ["Next.js", "MDX"]
slug: "mon-article"
Les avantages
- Performance : pages statiquement générées à la compilation
- SEO : meta tags dynamiques + schema.org Article
- DX : écriture en Markdown, preview instant avec le dev server
- Flexibilité : possibilité d'embarquer des composants React dans le contenu
- Versionning : chaque article est versionné dans Git
Conclusion
MDX est le choix idéal pour un blog technique intégré à un site Next.js. Simple, performant, et extensible à souhait.