HTML ou Markdown? Antes de usar o formato de saída do Claude Code, pense por 30 segundos sobre estas questões

O engenheiro do Claude Code defende substituir o 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.

O engenheiro do Claude Code defende HTML em vez de Markdown

Na era em que os 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 a maioria das IA e os utilizadores.

Mas recentemente, Thariq Shihipar, engenheiro do Claude Code, publicou que, à medida que as capacidades dos agentes de IA aumentam significativamente, o Markdown está se tornando 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 poderia trazer vantagens notáveis.

Ele aponta que, o 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 equipa de ler especificações técnicas e relatórios extensos. Ao partilhar, basta fazer upload do arquivo HTML na nuvem e partilhar o link, evitando problemas de suporte nativo limitado do 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 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?

O colunista interessado em criptomoedas e IA, The Smart Ape, acredita 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 na base de dados.

Ele recomenda refletir sobre estas três questões antes de solicitar à Claude Code que gere o formato desejado.

⭐Quem irá ler este documento?

Se o documento precisar ser relido por Claude ou outros agentes de IA, por exemplo, como índice de código ou referência de especificações técnicas, o Markdown é certamente a melhor escolha.

The Smart Ape aponta que o HTML contém muitos estilos e etiquetas, consumindo até três vezes mais tokens, além de diluir o sinal semântico, o que reduz a relevância na recuperação de informações em cerca de 15% a 25%; porém, se o documento for uma apresentação única para leitura humana, o HTML pode ser considerado.

⭐Quantas vezes este documento será editado?

Ao modificar documentos em Markdown, a IA geralmente precisa apenas substituir algumas linhas de texto. Já ao editar HTML com estilos, a IA 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 configurações de cores misturados.

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

⭐Qual é o ciclo de vida esperado do documento?

A durabilidade do arquivo também é uma consideração importante. Após seis meses, os desenvolvedores podem facilmente buscar por conteúdo Markdown usando palavras-chave, enquanto o HTML, devido à sua estrutura complexa de etiquetas, 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 e funcionalidades. Portanto, para documentos essenciais de longo prazo, o Markdown é preferível.

The Smart Ape sugere que o melhor é 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

⭐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 perfeitamente de volta para um Markdown limpo apenas com uma instrução? Se a resposta for não, significa que o conteúdo está profundamente acoplado à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 os humanos são seres visuais e, com o avanço da tecnologia de IA, os formatos de saída passarão por várias fases de evolução. Até prevê que, no futuro, essa evolução levará à geração direta de vídeos interativos ou ambientes simulados por redes neurais.

Leitura adicional:
Responsável pelo Claude Code: programar já foi resolvido por IA! Por que “/loop” é o futuro?

Claude Code + OnlyFans faturam dezenas de milhares de dólares por mês? Quanto de credibilidade há em artigos de empreendedorismo com 30 milhões de visualizações?