Publier un article technique en Markdown

Un article technique doit rester facile à écrire, à relire et à retrouver. Pour ce blog, son texte source est un fichier Markdown versionné avec le site.

Un fichier, une URL stable

Chaque article est enregistré dans src/posts/ sous un nom de fichier stable, par exemple markdown-versionne.md. Le frontmatter contient son titre, sa date, un résumé, ses tags et sa langue. Le nom du fichier devient le slug de l’URL.

Le changement suit le même chemin que le code : une branche, une merge request, puis une revue avant intégration. L’historique Git conserve les modifications et les discussions éditoriales restent attachées au changement.

Le build produit les pages

Pendant le build, MDsveX transforme le Markdown en composant Svelte et SvelteKit pré-rend la liste ainsi que les pages des articles connus. Le texte et sa structure sont déjà dans le HTML livré : JavaScript n’est pas nécessaire pour lire le contenu. Aucune base de données ou interface d’administration ne gère les publications.

Ce choix est adapté à des articles qui changent avec le code du site. Il ne remplace pas une plateforme éditoriale pour une équipe qui a besoin de publier fréquemment sans passer par une revue technique.

Publier une note

Ajouter un fichier .md avec le frontmatter attendu, lancer les vérifications et le build, puis ouvrir une merge request. Après revue et intégration, le déploiement d’une nouvelle version du site inclut la page à son URL stable.