HTML ou Markdown? Antes de usar o formato de saída do Claude Code, pense nisso por 30 segundos

Engenheiro do Claude Code defende a substituição do Markdown por HTML como formato padrão de saída de IA, gerando debates a favor e contra, com colunistas a sugerir que os usuários avaliem esses pontos antes de solicitar formatos à IA.

Engenheiro do Claude Code defende HTML em vez de Markdown

Na era em que agentes de IA (AI Agents) estão se tornando cada vez mais comuns, o formato Markdown tornou-se o padrão padrão de comunicação entre IA e usuários.

Mas recentemente, Thariq Shihipar, engenheiro do Claude Code, publicou que, à medida que as capacidades dos agentes de IA aumentam significativamente, o Markdown começa a se tornar uma limitação, pois documentos com mais de 100 linhas tornam-se difíceis de ler, além de apresentarem inconvenientes na partilha e visualização. Mudar o formato de saída do Claude Code para HTML pode trazer vantagens notáveis.

Ele aponta que, HTML possui uma densidade de informação extremamente alta, podendo apresentar dados de design via CSS, desenhar ilustrações com SVG e até integrar JavaScript para funcionalidades interativas bidirecionais.

Essas características tornam os documentos mais organizados visualmente e aumentam significativamente a disposição dos membros da equipe de ler especificações técnicas e relatórios extensos. Ao compartilhar, basta fazer o upload do arquivo HTML na nuvem e compartilhar o link, evitando problemas de suporte nativo ao Markdown em alguns navegadores.

Fonte da imagem: Thariq Shihipar　Engenheiro do Claude Code defende HTML em vez de Markdown

HTML ou Markdown? Pense em três questões antes de gerar a saída

A ideia de Shihipar de “substituir Markdown por HTML” rapidamente gerou debates e questionamentos na comunidade, mas o verdadeiro foco deveria ser: quando usar HTML, quando usar Markdown?

Colunistas que acompanham criptomoedas e IA, como The Smart Ape, acreditam que discutir qual formato é melhor é inútil; a escolha do formato depende totalmente do público-alvo do documento, da frequência de edição e do ciclo de vida. Se escolher o formato errado, pode gastar muitos tokens e tempo de edição, além de prejudicar a precisão das buscas no banco de dados.

Ele recomenda refletir sobre as seguintes três questões antes de solicitar que a IA gere o formato.

⭐Quem irá ler este documento?

Se o documento precisar ser relido por Claude ou outros agentes de IA, por exemplo, para indexar código ou consultar especificações técnicas, o Markdown é definitivamente a melhor escolha.

The Smart Ape aponta que, devido ao grande volume de estilos e tags, o HTML consome mais de três vezes a quantidade de tokens, além de diluir o significado, reduzindo a relevância na busca por IA em cerca de 15% a 25%; porém, se o documento for uma única entrega para leitura humana, o HTML pode ser considerado.

⭐Quantas vezes este documento será editado?

Ao modificar documentos em Markdown, a IA geralmente substitui algumas linhas de texto. Em HTML, ao editar, ela tende a reescrever também as marcações ao redor. Após 5 a 10 edições, o documento HTML pode apresentar problemas graves de “deslocamento de marcações”, com múltiplos sistemas de espaçamento e cores misturados.

The Smart Ape acredita que, se o documento for frequentemente alterado, usar Markdown garante maior estabilidade, enquanto HTML é mais adequado para versões finais de publicação.

⭐Qual é o ciclo de vida esperado do documento?

A durabilidade do arquivo também é importante. Após 6 meses, desenvolvedores podem facilmente buscar por conteúdo Markdown usando palavras-chave, enquanto no HTML, a estrutura complexa de tags pode dificultar buscas.

Além disso, um arquivo Markdown de anos atrás ainda pode ser aberto de forma limpa, enquanto um HTML que depende de recursos externos pode perder estilos ao longo do tempo. Para documentos essenciais de longo prazo, o Markdown é a melhor base.

The Smart Ape sugere que o ideal é tratar o Markdown como uma fonte única de verdade, gerando dinamicamente HTML conforme a necessidade para diferentes públicos.

Fonte da imagem: The Smart ApeHTML ou Markdown? Pense em três questões antes de gerar a saída

⭐Faça um teste de reversibilidade em 30 segundos

The Smart Ape também compartilhou um teste de reversibilidade de 30 segundos, como uma última verificação.

Antes de optar pelo HTML, pergunte-se: Este documento pode ser convertido de forma perfeita de volta para um Markdown limpo apenas com uma instrução? Se a resposta for não, significa que o conteúdo está profundamente vinculado às marcações, e o documento pode se tornar difícil de manter no futuro.

Cientista da computação: espera-se uma grande evolução na interação com IA

Embora a discussão sobre HTML versus Markdown gere debates, o ex-cientista da OpenAI, Andrej Karpathy, vê o lado positivo.

Ele aponta que, ao solicitar ao LLM no final do prompt que gere a saída em HTML e abrir o arquivo no navegador, essa abordagem é bastante eficaz atualmente. Ele também conseguiu fazer a IA criar apresentações de slides e outros formatos.

Acredita que, como seres visuais, à medida que a tecnologia de IA avança, os formatos de saída passarão por várias fases de evolução. Até prevê que, no futuro, essa evolução levará a vídeos interativos ou ambientes simulados gerados diretamente por redes neurais.