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 créer 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 le manque de support natif du Markdown dans 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 du cycle de vie du document. Si le mauvais format est choisi, cela peut entraîner une consommation excessive de tokens, du temps d’édition, voire nuire à la précision des recherches 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 de 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 trois fois plus de tokens, 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, l’utilisation du HTML peut être envisagée.

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

Lorsqu’on modifie un fichier Markdown, l’IA doit généralement ne remplacer que quelques lignes. En revanche, pour un fichier 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 configurations 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é d’un fichier est également un facteur important. Après six mois, un développeur peut facilement retrouver un contenu Markdown précis dans un projet via des mots-clés, alors qu’une recherche dans un HTML complexe peut échouer à cause de la structure de balises.

De plus, un fichier Markdown ancien peut encore s’ouvrir proprement aujourd’hui, alors 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 pense que la meilleure pratique consiste à considérer le Markdown comme la source unique de vérité, et à 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 également un test réversible de 30 secondes, comme dernier critère de validation.

Avant d’opter pour le HTML, demandez-vous : Ce document peut-il être parfaitement reconverti en Markdown propre via une seule invite ? Si la réponse est non, cela signifie que le contenu est profondément lié au langage de balisage, et qu’il sera difficile à maintenir à l’avenir.

Les informaticiens : espèrent une grande évolution 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 généré dans un navigateur, cette méthode est très efficace à l’heure actuelle. Il a également réussi à faire produire par l’IA des présentations sous forme de diapositives, etc.

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

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é dans cet article sur une startup IA ayant 30 millions de vues ?