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 questions avant de demander à l’IA de générer un format.

Les ingénieurs de Claude Code prônent le HTML au lieu 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 il présente de nombreux inconvénients pour le partage et la visualisation. 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 conception via CSS, de dessiner des illustrations avec SVG, et même de combiner JavaScript pour une interactivité bidirectionnelle.

Ces caractéristiques rendent les documents plus structurés visuellement et augmentent considérablement la volonté des membres de l’équipe de lire de longues spécifications techniques et 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 au lieu 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 format n’a pas de sens. Le choix dépend entièrement du public cible, de la fréquence d’édition et du cycle de vie du document. Si le mauvais format est choisi, cela peut coûter cher en tokens et en temps d’édition, et même 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 va lire 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 contient beaucoup de styles et d’étiquettes, ce qui peut consommer jusqu’à trois fois plus de tokens, et diluer la signification, réduisant la pertinence lors de recherches ultérieures d’environ 15 % à 25 %. Mais 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 la 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 également un facteur important. Après 6 mois, un développeur peut facilement rechercher un contenu Markdown spécifique dans un projet via des mots-clés, alors que dans un HTML complexe, la recherche peut échouer à cause de la structure de balises.

De plus, un fichier Markdown ancien peut encore être ouvert proprement, alors qu’un fichier HTML dépendant de ressources externes peut voir ses styles disparaître. Pour des documents essentiels à long terme, le Markdown reste la meilleure option.

The Smart Ape pense que la meilleure pratique consiste à considérer le Markdown comme la source unique de vérité, puis à 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 de reversibilité en 30 secondes

The Smart Ape partage également un test de reversibilité 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 à l’aide d’un seul prompt ? 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 avec l’IA

Bien que le débat sur le choix entre HTML et Markdown fasse rage, l’ancien scientifique en informatique 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, avec l’avancement de la technologie IA, les formats de sortie évolueront par étapes. Il prévoit même que cette évolution mènera à des vidéos interactives ou des environnements simulés générés directement par des réseaux neuronaux.