Ingénieurs d’Anthropic : le HTML est le meilleur format de sortie pour Claude Code, pas Markdown

L’ingénieur du code Claude d’Anthropic, Thariq Shihipar, a publié le 8 mai « Using Claude Code: The Unreasonable Effectiveness of HTML », affirmant que le HTML devrait remplacer le Markdown comme format de sortie pour interagir avec Claude Code. Simon Willison résume les points clés : le HTML offre des graphiques SVG, des composants interactifs, des ancres dans la page et des styles CSS, permettant aux réponses de Claude de passer d’un texte « linéaire » à des documents « multidimensionnels », améliorant nettement la lisibilité et l’efficacité de la compréhension. Le sujet est extrêmement populaire sur la plateforme X : les deux publications de Shihipar à ce propos cumulent plus de 15 000 likes.

Thèse centrale : le HTML offre des capacités visuelles et interactives que le Markdown ne peut pas fournir

Shihipar avance les raisons pour lesquelles le HTML dépasse le Markdown :

Richesse visuelle : graphiques SVG, codage par couleurs, callouts stylés

Interactivité : prise en charge native des widgets et des éléments dynamiques

Navigation : ancres intra-page, hiérarchies structurées de l’information

Mise en page professionnelle : les styles CSS renforcent la clarté et l’esthétique

Si le Markdown est devenu une norme, c’est surtout parce que, dans les débuts, la fenêtre de contexte des LLM était plutôt limitée (par exemple à l’époque de GPT-4 en 8K) et que les développeurs devaient économiser des tokens ; les balises HTML consomment davantage de tokens que le Markdown, ce qui n’était pas rentable à l’ère des contextes réduits. Depuis l’arrivée de Claude dans l’ère du contexte de 200 000 à 1 million, le coût des tokens n’est plus une contrainte, et les avantages visuels du HTML peuvent pleinement s’exprimer.

Cas d’application concret : lors de l’analyse de failles Linux, générer des documents techniques à thème sombre avec une sortie HTML

Shihipar prend l’analyse de vulnérabilités de sécurité sous Linux comme exemple :

Sortie Markdown : texte pur, reposant sur l’indentation et la hiérarchie par titres

Sortie HTML : document technique à thème sombre, niveaux de gravité codés par couleurs, tableaux de comparaison côte à côte, blocs d’avertissement

Expérience lecteur : la version HTML rend la hiérarchie, le niveau de gravité et les relations de comparaison lisibles en un coup d’œil

Avec le même contenu informatif, la lisibilité et la capacité à agir de la sortie HTML surpassent largement la version texte pur en Markdown. Pour les scénarios où il faut produire une « explication destinée aux humains » (et non du « texte pur pour les machines »), HTML est un meilleur choix.

Mode d’emploi recommandé : demander explicitement au prompt des capacités complètes en HTML + CSS + JS

Le modèle de prompt recommandé par Shihipar :

« Sortir du HTML, utiliser du HTML, avec les capacités complètes en HTML, CSS et JavaScript pour rendre l’explication riche, interactive et claire »

Adapté à : la documentation technique, les explications pédagogiques, la visualisation de données, les rapports interactifs

Non adapté à : de simples fichiers de code, des données structurées (utiliser encore le format correspondant)

Événements précis à suivre ensuite : si Anthropic recommandera officiellement la capacité de sortie HTML aux utilisateurs de Claude Code, si d’autres cadres IDE/Agent (Cursor, Codex) adopteront des formats de sortie similaires, et comment évolueront, à long terme, les taux d’adoption de Markdown versus HTML dans la communauté des développeurs.

Cet article affirme : « Un ingénieur d’Anthropic : le HTML est le meilleur format de sortie pour Claude Code, pas le Markdown », publié le plus tôt dans ABMedia sur la chaîne.