HTML ou Markdown ? Avant d'utiliser le format de sortie Claude Code, prenez 30 secondes pour réfléchir à ces choses

Les ingénieurs de Claude Code prônent le remplacement du Markdown par le HTML comme format par défaut pour la sortie de l’IA, ce qui a suscité des débats en faveur et en défaveur. Certains chroniqueurs suggèrent aux utilisateurs de prendre 30 secondes pour évaluer ces enjeux avant de demander à l’IA de générer un format.

Les ingénieurs de Claude Code prônent le HTML en remplacement du Markdown

Dans un contexte où les agents IA (AI Agents) deviennent de plus en plus courants, le format Markdown est devenu la norme par défaut pour la communication entre IA et utilisateurs.

Mais récemment, Thariq Shihipar, ingénieur chez Claude Code, a publié un message indiquant qu’avec l’amélioration significative des capacités des agents IA, le Markdown devient une limite. Les fichiers Markdown de plus de 100 lignes sont difficiles à lire, et leur partage ou visualisation pose de nombreux problèmes. Passer le format de sortie de Claude Code à HTML pourrait offrir des avantages notables.

Il souligne que, le HTML possède une densité d’informations extrêmement élevée, permettant de présenter des données de design via CSS, de dessiner des illustrations avec SVG, voire d’intégrer JavaScript pour une interactivité bidirectionnelle.

Ces caractéristiques rendent les documents plus structurés visuellement et augmentent considérablement la volonté des membres d’une équipe de lire de longues spécifications techniques ou rapports. Lors du partage, il suffit de télécharger le fichier HTML sur un espace cloud pour le consulter facilement via un lien, évitant ainsi les limitations du Markdown sur certains navigateurs.

Source : Thariq Shihipar　Les ingénieurs de Claude Code prônent le HTML en remplacement du Markdown

HTML ou Markdown ? Réfléchissez à trois questions avant de sortir

L’idée de Shihipar selon laquelle « le HTML remplace le Markdown » a rapidement suscité des débats et des critiques dans la communauté, mais le vrai enjeu est : quand faut-il utiliser le HTML, quand le Markdown ?

Un chroniqueur spécialisé en cryptomonnaies et IA, The Smart Ape, pense que débattre de la meilleure norme est inutile. Le choix du format dépend entièrement du public cible, de la fréquence de modification et de la durée de vie du document. Si le mauvais format est choisi, cela peut entraîner une consommation excessive de tokens et de temps d’édition, voire nuire à la recherche dans la base de données.

Il recommande de réfléchir à ces trois questions avant de demander à Claude Code de générer un format.

⭐Qui lira ce document ?

Si ce document doit être relu par Claude ou d’autres agents IA, par exemple pour l’indexation du code ou comme référence pour des spécifications techniques, le Markdown est sans doute le meilleur choix.

The Smart Ape indique que le HTML, contenant beaucoup de styles et de balises, consomme plus de tokens — jusqu’à trois fois plus — et dilue le signal sémantique, ce qui réduit la pertinence des recherches ultérieures d’environ 15 % à 25 %. Cependant, si le document est une seule fois destiné à une lecture humaine, le HTML peut être envisagé.

⭐Combien de fois ce document sera-t-il modifié ?

Lorsqu’on modifie un fichier Markdown, l’IA doit généralement ne changer que quelques lignes. En revanche, pour un HTML avec styles, l’IA réécrira souvent tout le contenu, y compris les balises environnantes. Après 5 à 10 modifications, le fichier HTML peut présenter de graves décalages de balises, avec un mélange de multiples systèmes d’espacement et de couleurs.

The Smart Ape pense que si le document doit être modifié fréquemment, le Markdown garantit une stabilité du contenu, tandis que le HTML est réservé à la version finale pour publication.

⭐Quelle est la durée de vie de ce document ?

La pérennité du fichier est aussi un facteur important. Après six mois, un développeur peut facilement retrouver un contenu Markdown précis via des mots-clés dans le projet, alors qu’un HTML, avec ses structures de balises complexes, peut rendre la recherche difficile.

De plus, un fichier Markdown ancien peut encore s’ouvrir proprement, tandis qu’un HTML dépendant de ressources externes peut voir ses styles disparaître. Pour des documents essentiels à long terme, le Markdown reste la référence.

The Smart Ape recommande de considérer le Markdown comme la source unique de vérité, et de générer dynamiquement du HTML selon les besoins pour différents publics.

Source : The Smart ApeHTML ou Markdown ? Réfléchissez à trois questions avant de sortir

⭐ Faites un test réversible en 30 secondes

The Smart Ape partage aussi un test réversible de 30 secondes, comme dernier critère de validation.

Avant d’opter pour le HTML, demandez-vous : est-il possible de convertir parfaitement ce document en Markdown propre via une seule instruction ? Si la réponse est non, cela signifie que le contenu est profondément lié aux balises, et le document pourrait devenir difficile à maintenir à l’avenir.

Les informaticiens : espèrent une grande avancée dans l’interaction IA

Bien que le débat sur le choix entre HTML et Markdown fasse rage, l’ancien scientifique chez OpenAI, Andrej Karpathy, reste optimiste.

Il indique que, en demandant à un LLM de produire du HTML à la fin d’un prompt, puis en ouvrant le fichier dans un navigateur, cette méthode est très efficace à l’heure actuelle. Il a lui-même réussi à faire produire à l’IA des présentations sous forme de diapositives, par exemple.

Il pense que, étant des animaux visuels, les humains verront l’évolution des formats de sortie en plusieurs phases. Il prévoit même que cette tendance mènera à des environnements interactifs générés directement par des réseaux neuronaux, comme des vidéos ou des simulations.

Lecture complémentaire :
Le responsable de Claude Code : La programmation est déjà résolue par l’IA ! Pourquoi le « /loop » est l’avenir ?

Claude Code + OnlyFans gagne plusieurs milliers de dollars par mois ? Combien de crédibilité pour cet article de startup IA avec 30 millions de vues ?