Engenheiros da Anthropic: o HTML é o melhor formato de saída para o Claude Code, e não o Markdown

A equipa de engenheiros do Anthropic Claude Code, Thariq Shihipar, publicou a 8 de maio “Using Claude Code: The Unreasonable Effectiveness of HTML”, defendendo que o HTML deve substituir o Markdown como formato de saída para interagir com o Claude Code. Simon Willison resumiu os pontos principais: o HTML fornece gráficos SVG, elementos de interacção, âncoras na própria página e estilos CSS, permitindo que as respostas do Claude passem de “texto linear” para um “documento multidimensional”, melhorando significativamente a eficiência de leitura e compreensão. O tema está a ganhar enorme tração na plataforma X — as duas publicações relacionadas de Shihipar somam mais de 15,000 gostos.

Tese central: o HTML oferece capacidades visuais e de interacção que o Markdown não tem

Shihipar defende que o HTML supera o Markdown pelas seguintes razões:

Riqueza visual: gráficos SVG, codificação por cores e callouts com estilo

Interactividade: suporte nativo para widgets e componentes dinâmicos

Navegação: âncoras dentro da página e níveis hierárquicos estruturados da informação

Produção profissional: estilos CSS que aumentam a clareza e a estética

O facto de o Markdown se ter tornado padrão deve-se sobretudo ao contexto inicial dos LLM, que tinha janelas de contexto pequenas (como na era do GPT-4 8K), obrigando os programadores a poupar tokens; já as etiquetas do HTML consomem mais tokens do que o Markdown, pelo que, numa época de contexto reduzido, não compensava. Com a entrada na era de contextos entre 200K e 1M tokens, o custo de tokens deixa de ser uma limitação, e só então as vantagens visuais do HTML conseguem ser plenamente aproveitadas.

Aplicações concretas: ao analisar vulnerabilidades no Linux, gerar documentação técnica com temas escuros via HTML

Shihipar usa como exemplo a análise de vulnerabilidades de segurança no Linux:

Saída em Markdown: apenas texto, apoiado em recuos e hierarquização por títulos

Saída em HTML: documentação técnica com tema escuro, com codificação por cores para níveis de gravidade, tabelas de comparação lado a lado e blocos de aviso

Experiência do leitor: a versão em HTML permite identificar de imediato a hierarquia do conteúdo técnico, o nível de gravidade e as relações de comparação

Com o mesmo conteúdo informativo, a legibilidade e a capacidade de acção da saída em HTML superam claramente a versão em texto puro do Markdown. Para cenários que exigem gerar “explicações para pessoas” (e não “texto puro para máquinas”), o HTML é uma escolha melhor.

Forma recomendada de uso: exigir de forma explícita no prompt as capacidades completas de HTML + CSS + JS

Shihipar recomenda o seguinte padrão para prompts:

“Produz HTML, usa HTML, e utiliza as capacidades completas de HTML, CSS e JavaScript para tornar a explicação mais rica, interactivia e clara”

Adequado para: documentação técnica, explicações de ensino, visualização de dados, relatórios interactivos

Não adequado para: ficheiros de código puramente, dados estruturados (ainda assim, usar o formato correspondente)

Eventos concretos a acompanhar em seguida: se a Anthropic vai recomendar oficialmente a capacidade de saída em HTML para utilizadores do Claude Code, se outras frameworks de IDE/Agent (Cursor, Codex) adotam formatos de saída semelhantes e como evolui a taxa de adopção de longo prazo de Markdown vs HTML na comunidade de programadores.

Este artigo do engenheiro da Anthropic: “HTML é o melhor formato de saída para o Claude Code, e não o Markdown”, publicado na ABMedia do mundo das “cadeias de notícias”.