Cet article est lui-même un fichier nommé writing-in-mdx.mdx, posé dans un dossier de mon dépôt. Je l'ai écrit dans mon éditeur de code, enregistré, poussé, et il est apparu ici avec sa date, son temps de lecture et sa typographie. C'est toute la chaîne de publication.
Comment ça marche
Chaque article commence par un petit en-tête (le frontmatter) :
---
title: "Mon prochain article"
date: "2026-07-10"
tag: "Notes"
description: "Une phrase qui donne envie de cliquer."
---
En dessous, du markdown classique : titres, listes, liens, code. Comme c'est du MDX et pas seulement du markdown, je peux aussi glisser des composants React au milieu du texte quand une idée a besoin de plus que des mots.
Ce que le site fait tout seul
Je n'écris que le texte. Le reste est calculé à partir du fichier :
- l'adresse de l'article vient du nom du fichier :
writing-in-mdx.mdxdevient/blog/writing-in-mdx; - le temps de lecture est compté sur le texte, à raison de 200 mots par minute ;
- l'ordre de la liste suit la date de l'en-tête, du plus récent au plus ancien ;
- les filtres du blog viennent du champ
tag: un nouveau sujet crée son filtre tout seul ; - la couverture est dessinée par le site quand l'article n'a pas d'image, à partir de ce qu'il raconte.
Ce dernier point m'évite la corvée qui tue les blogs : fabriquer une image pour chaque article. Un article de hackathon reçoit un dossard avec sa place. Un épisode de série reçoit une affiche avec son numéro. Celui-ci reçoit le dessin d'un fichier qui devient une page.
Deux langues, deux fichiers
Le site existe en français et en anglais. Chaque article a donc deux fichiers qui portent le même nom :
content/blog/writing-in-mdx.mdx la version anglaise, avec la date et le sujet
content/blog/fr/writing-in-mdx.mdx la version française : titre, résumé et texte
La date et le sujet ne sont écrits qu'une fois, dans le fichier anglais. Le fichier français ne redonne que ce qui se traduit. Si la version française manque, le site affiche la version anglaise plutôt qu'une page vide.
Des composants au milieu du texte
C'est là que MDX se distingue du markdown. Dans ma série sur l'hébergement, certains passages demandaient un schéma : le trajet d'une requête, l'anatomie d'un nom de domaine. Plutôt que d'exporter des images, j'ai écrit des composants React, et je les appelle dans l'article comme une balise.
Le schéma suit alors le thème clair ou sombre, reste net à toutes les tailles, et se corrige comme du code. Une image exportée, elle, est à refaire à chaque changement.
Il y a une limite à respecter : un composant par idée qui en a vraiment besoin. Un article rempli de widgets devient une application, et plus personne ne le lit.
Pourquoi j'aime ça
- Versionné comme du code : chaque modification est un commit git, les fautes de frappe ont un historique ;
- Aucun panneau d'administration à sécuriser, aucune base de données à sauvegarder ;
- L'éditeur dans lequel je vis déjà devient l'outil d'écriture ;
- Des pages prêtes à l'avance : les articles sont construits une fois, au déploiement, et servis tels quels. Rien à calculer quand quelqu'un arrive.
Ce que ça coûte
Ce système n'est pas pour tout le monde, et autant le dire.
- Il faut savoir utiliser git. Pour un développeur, c'est un avantage. Pour quelqu'un d'autre, c'est un mur.
- Pas d'aperçu en un clic depuis un téléphone : j'écris sur mon ordinateur, je regarde le résultat en local, puis je pousse.
- Pas de programmation de publication. Un article est en ligne quand il est poussé, pas avant.
- Les images sont à ranger soi-même dans le dépôt.
Pour un blog personnel tenu par un développeur, ces contraintes ne pèsent presque rien. Pour une équipe éditoriale, un vrai CMS reste le bon choix.
Écrire le prochain
Mon parcours pour un nouvel article tient en quatre gestes : créer le fichier, remplir l'en-tête, écrire, pousser.
Si vous êtes développeur et que vous pensez écrire davantage : supprimez toutes les excuses entre vous et la publication. La mienne tient désormais en un seul fichier.
