HTML ainda é Markdown? Antes de usar o formato de saída do Claude Code, pense nessas coisas 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 sugerindo que os usuários avaliem esses pontos antes de solicitar formatos de 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 já se estabeleceu como padrão para 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 se torna 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 exibir 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, eliminando o problema 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 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 verdadeiro foco deveria ser: quando usar HTML e 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 o Claude Code gere um 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 até três vezes mais 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, normalmente basta trocar 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 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 o HTML, devido às suas estruturas complexas, pode dificultar buscas.

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

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 de 30 segundos antes de decidir

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 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 que gere saída em HTML ao final de prompts e abrir esses arquivos no navegador, essa prática é bastante eficaz atualmente. Ele também conseguiu fazer a IA criar apresentações de slides e outros formatos a partir dessas saídas.

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, veremos vídeos interativos ou ambientes simulados gerados diretamente por redes neurais.

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

Claude Code+OnlyFans faturando 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?