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

A equipe de engenheiros do Claude Code da Anthropic, Thariq Shihipar, publicou em 8 de maio o texto “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 reuniu os pontos principais: o HTML oferece gráficos SVG, componentes interativos, âncoras na própria página e estilos CSS, fazendo com que as respostas do Claude deixem de ser “texto linear” e passem a ser “documentos em múltiplas dimensões”, o que pode melhorar bastante a eficiência de leitura e compreensão. O tema está em alta no X — as duas postagens relacionadas de Shihipar somam mais de 15.000 curtidas.

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

Shihipar argumenta que o HTML supera o Markdown por estes motivos:

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

Interatividade: suporte nativo a widgets e elementos dinâmicos

Navegação: âncoras na própria página e hierarquias de informação estruturadas

Formatação profissional: estilos CSS melhoram a clareza e a aparência

O motivo pelo qual o Markdown virou padrão no passado foi, principalmente, porque as primeiras gerações de LLM tinham janelas de contextos menores (como na época do GPT-4 8K), levando desenvolvedores a economizar tokens; já as tags do HTML consomem mais tokens do que o Markdown em si, e não valia a pena na era de contextos pequenos. Depois da era do contexto de 200K a 1M para o Claude, o custo de tokens deixou de ser uma limitação, e as vantagens visuais do HTML podem ser aproveitadas plenamente.

Aplicações concretas: ao analisar vulnerabilidades no Linux, gerar documentos técnicos em tema escuro com saída em HTML

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

Saída em Markdown: texto puro, usando recuos e hierarquias de títulos

Saída em HTML: documentos técnicos em tema escuro, com níveis de gravidade codificados por cor, tabelas comparativas lado a lado e blocos de alerta

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

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

Forma recomendada de uso: exigir explicitamente, no prompt, a capacidade completa de HTML + CSS + JS

Shihipar recomenda este padrão de prompt:

“Exporte HTML, use as capacidades completas de HTML, CSS e JavaScript para deixar a explicação rica, interativa e clara”

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

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

Eventos específicos que podem ser acompanhados depois: se a Anthropic vai recomendar oficialmente a capacidade de saída em HTML para usuários do Claude Code, se outros frameworks de IDE/Agent (Cursor, Codex) vão adotar formatos de saída semelhantes e como a taxa de adoção de Markdown vs HTML deve variar no longo prazo na comunidade de desenvolvedores.

Este artigo afirma: engenheiros da Anthropic — HTML é o melhor formato de saída para o Claude Code, não o Markdown, que surgiu primeiro na cadeia de notícias ABMedia.