Est-ce la fin du Markdown ?
Mike Codeur
Pendant des années, Markdown a été le format naturel pour travailler avec les IA. Il est simple, lisible, versionnable, facile à donner en contexte à un agent, et parfait pour écrire des specs, des prompts ou de la documentation légère.
Mais une idée intéressante circule depuis l'équipe Claude Code chez Anthropic : pour certains outputs destinés aux humains, HTML devient plus puissant que Markdown.
La nuance est importante. Markdown n'est pas mort. Mais il n'est pas toujours le meilleur format quand l'objectif n'est plus seulement de lire du texte, mais de comprendre, comparer, manipuler ou décider.
Pourquoi Markdown a gagné avec les IA
Markdown fonctionne très bien parce qu'il coche presque toutes les cases utiles pour un agent :
- il reste lisible en texte brut ;
- il est facile à versionner dans Git ;
- il se copie-colle très bien dans un prompt ;
- il marche pour les specs, les plans, les résumés et les notes ;
- il est léger en tokens par rapport à des formats plus verbeux.
Pour nourrir une IA avec du contexte, Markdown reste excellent. Si tu veux donner une spec produit, un README, une liste de règles ou un plan de travail à Claude Code, Markdown est encore probablement le meilleur choix.
Là où Markdown commence à montrer ses limites
Le problème apparaît quand l'agent ne produit plus seulement une réponse textuelle.
Quand tu demandes à une IA de t'aider à :
- comparer plusieurs options ;
- explorer une architecture ;
- comprendre un flux complexe ;
- prioriser des tickets ;
- visualiser une review de code ;
- prendre une décision produit ;
- lire un rapport avec plusieurs niveaux d'information.
Dans ces cas-là, un long fichier Markdown peut devenir lourd. Tu scrolles. Tu lis. Tu reconstruis mentalement la structure. Et parfois, tu finis par abandonner avant d'avoir vraiment exploité le résultat.
Pourquoi HTML devient intéressant
HTML permet à l'agent de générer autre chose qu'un texte : une mini-interface.
Pas forcément une application complète. Souvent juste un fichier temporaire, ouvert dans le navigateur, qui sert à comprendre ou décider plus vite.
Exemples concrets :
| Besoin | Markdown | HTML |
|---|---|---|
| Comparer des pistes | liste textuelle | cartes visuelles côte à côte |
| Explorer un concept | explication linéaire | schéma interactif |
| Prioriser des tâches | tableau statique | colonnes manipulables |
| Lire une review de code | blocs de texte | vue structurée par fichier |
| Présenter un rapport | document long | dashboard navigable |
Ce n'est pas juste une question d'esthétique. Le vrai sujet, c'est la décidabilité.
Une interface bien générée peut rendre une information plus claire, plus manipulable et plus actionnable qu'un bloc de Markdown de 200 lignes.
Le bon modèle mental
La bonne conclusion n'est pas "HTML remplace Markdown partout".
La vraie distinction est plutôt :
Markdown pour nourrir l'IA. HTML pour nourrir l'humain.
Markdown reste excellent pour les inputs : contexte, specs, règles, documentation, mémoire, RAG.
HTML devient intéressant pour certains outputs : dashboards, visualisations, explorations, rapports interactifs, mini-outils, livrables temporaires.
Pourquoi ça change la manière de travailler avec les agents
Plus les agents IA produisent de choses, plus le format de restitution devient important.
Si l'agent génère 100 lignes, Markdown suffit.
S'il génère un livrable que tu dois vraiment utiliser, relire, comparer ou manipuler, HTML peut devenir beaucoup plus adapté.
C'est une évolution importante dans les workflows agentiques : on ne demande plus seulement à l'IA de répondre, on lui demande parfois de construire une interface jetable pour nous aider à réfléchir.
Voir la vidéo
J'explique les cas précis où HTML commence à prendre la place de Markdown dans cette vidéo : https://mkc.sh/html-markdown?utm_source=blog
Et si tu veux recevoir mes prochains retours sur Claude Code, les agents IA et les workflows de dev agentique, je partage ça dans The Agentic Dev : https://mkc.sh/the-agentic-dev?utm_source=blog