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

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 sugerindo que os usuários avaliem esses pontos antes de solicitar formatos à IA.

Engenheiro do Claude Code defende HTML ao invés de Markdown

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

Porém, recentemente, Thariq Shihipar, engenheiro do Claude Code, publicou que, com a grande melhora na capacidade dos agentes de IA, 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 significativas.

Ele aponta que, o HTML possui uma densidade de informação extremamente alta, podendo exibir dados de design via CSS, criar 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 ao invés de Markdown

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

A ideia de Shihipar de “substituir Markdown por HTML” rapidamente gerou debates e questionamentos na comunidade, mas o foco real 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 na busca de dados no banco de dados.

Ele sugere que, antes de solicitar que a IA do Claude Code gere o formato, o usuário pense nas seguintes três perguntas.

⭐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 3 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. Com HTML, ela tende a reescrever também as marcações ao redor. Após 5 a 10 edições, o documento HTML pode apresentar problemas de “deslocamento de marcações”, com mistura de diferentes sistemas de espaçamento e cores.

The Smart Ape acredita que, se o documento for frequentemente alterado, usar Markdown garante maior estabilidade do conteúdo, enquanto 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 é importante. Após 6 meses, desenvolvedores podem facilmente buscar por conteúdo Markdown usando palavras-chave, enquanto o HTML, devido à sua estrutura complexa, 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 HTML dinamicamente conforme a necessidade para diferentes públicos.

Fonte da imagem: The Smart ApeHTML ou Markdown? Pense em três perguntas 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 um prompt? 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 usar HTML ou 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 a partir dessa saída.

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. Ele até prevê que, no futuro, a geração de vídeos interativos ou ambientes simulados por redes neurais será uma realidade.

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

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