Agentes Explicam Melhor em HTML

Então talvez o problema não seja Markdown.

Talvez seja que a gente pede Markdown por reflexo.

O empurrãozinho mais recente veio do Thariq Shihipar, que trabalha no Claude Code na Anthropic. O argumento dele é simples: quando você pede para um agente explicar uma coisa complicada, pare de cair no Markdown por reflexo. Peça um artefato HTML autocontido.

O Simon Willison pegou a ideia na sexta e teve a mesma reação que muita gente teve: espera, por que eu ainda estou pedindo tudo como documento linear?

Eu entendo. Markdown é a caneca da casa da escrita técnica. Barato, resistente, sempre por perto. Mas às vezes você não está tentando tomar café. Às vezes você está tentando abrir uma placa bagunçada em cima da mesa e apontar para a parte que queimou.

É aí que HTML fica interessante para agentes.

Markdown é um corredor

Markdown é maravilhoso quando o formato da resposta é basicamente texto:

um resumo
um checklist
um changelog
uma explicação curta
um post como este

Ele é menos maravilhoso quando o formato da resposta é espacial.

Um pull request é espacial. Tem um diff, uma anotação do lado do diff, uma etiqueta de severidade, um link para pular para o arquivo importante.

Uma arquitetura de sistema é espacial. Caixas, setas, caminho principal, caminho sem graça, caminho assustador.

Uma revisão de design é espacial. Amostras de cor, estados de componente, espaçamento, tipografia, a coisa que você precisa ver ao lado da outra coisa.

Markdown consegue descrever tudo isso, mas ele tende a transformar a sala em um corredor. Tudo vira pilha vertical. Você rola, lembra, rola, compara, esquece, volta.

HTML deixa o agente colocar a mesa de volta na mesa.

O navegador é o caderno de rascunho do agente

A galeria de exemplos do Thariq é a parte útil. Tem pequenos HTMLs de arquivo único para code review, plano de implementação, design system, timeline de incidente, editor de feature flags, slide deck e explicadores de conceito.

Nada disso é magia. Esse é o ponto.

Um agente já consegue escrever:

uma <table> com colunas ordenáveis
um diagrama pequeno com SVG inline
seções recolhíveis para detalhes barulhentos
abas para caminhos alternativos de código
um slider para um parâmetro
um botão de copiar para o resultado final

A diferença é que esses blocos mudam o que você pode pedir.

"Explica este PR" vira "mostra os arquivos arriscados, anota o diff, colore os achados e deixa o mapa do módulo visível."

"Resume este incidente" vira "monta uma timeline onde eu possa expandir as linhas de log."

"Me ajuda a escolher uma direção de design" vira "renderiza três direções lado a lado para eu reagir com os olhos, não com a imaginação."

Isso não substitui escrita. Substitui a fingida de que toda tarefa de pensamento quer virar memorando.

A parte engraçada

Passamos anos fazendo web app parecer mais com editor de documentos.

Agora os agentes estão lembrando a gente de que um documento pode parecer mais com um web app minúsculo.

Tem um loop muito 2026 aqui. Pedimos pro modelo escrever texto porque texto é fácil de colar no chat. O modelo consegue montar uma interface pequena, mas a gente não pede porque a caixa de chat nos faz pensar em parágrafos. Aí alguém diz "tenta HTML" e a sala inteira lembra que o navegador tem layout, cor, interação e links há décadas.

O futuro chegou, olhou em volta e pediu um index.html.

Quando pedir HTML

Minha nova regra é bem simples:

Se a saída precisa de...	Peça...
leitura em ordem	Markdown
comparação entre opções	HTML
inspeção de código	HTML
notas simples para compartilhar	Markdown
explicar uma peça em movimento	HTML
documentação durável	Markdown primeiro, HTML se ajudar

Tem uma ressalva importante: artefatos HTML ainda são código gerado. Se a página inclui JavaScript, trate como qualquer outro script. Não cole segredos nela. Não rode artefato aleatório de desconhecido. Não confunda "parece documento" com "não executa nada."

Mas para o seu próprio agente, no seu próprio workspace, em uma tarefa comum de explicação? É uma ideia de baixo atrito e estranhamente gostosa de usar.

Na próxima vez que você for pedir "uma explicação detalhada em Markdown", tenta isto:

Explique isto como uma página HTML autocontida. Use layout, tabelas, diagramas, cor e pequenas interações quando isso deixar a ideia mais fácil de inspecionar. Mantenha legível sem assets externos.

No pior caso, você ganha uma nota um pouco estilizada demais.

No melhor caso, você lembra que a web já era um meio interativo antes do chat convencer a gente de que tudo precisava virar scrollback.

Bom domingo. Vai fazer uma página minúscula.

Sources

Simon Willison — Using Claude Code: The Unreasonable Effectiveness of HTML — o link post que trouxe o argumento do Thariq Shihipar e o experimento do Simon com HTML gerado por GPT-5.5
The unreasonable effectiveness of HTML — examples — a galeria companheira do Thariq Shihipar com exemplos de HTMLs autocontidos gerados por agente
Anthropic Help Center — What are artifacts and how do I use them? — contexto oficial sobre artifacts do Claude, incluindo saídas HTML de página única
Claude Code overview — documentação oficial do agente de código da Anthropic