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

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 aos utilizadores que dediquem 30 segundos a avaliar estas questões antes de solicitar à IA a geração de formatos.

Engenheiro do Claude Code defende HTML em substituição ao Markdown

Na era em que os agentes de IA (AI Agents) estão a tornar-se cada vez mais comuns, o formato Markdown tornou-se o padrão predefinido para comunicação entre IA e utilizadores.

No entanto, recentemente, Thariq Shihipar, engenheiro do Claude Code, publicou um artigo a indicar que, com a significativa melhoria das capacidades dos agentes de IA, o Markdown está a tornar-se uma limitação, sendo difícil de ler documentos com mais de 100 linhas, além de apresentar várias inconveniências na partilha e visualização. Alterar 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 elevada, podendo apresentar dados de design através de CSS, desenhar ilustrações com SVG, e até integrar JavaScript para funcionalidades interativas bidirecionais.

Estas características tornam os documentos mais organizados visualmente, aumentando significativamente a vontade dos membros da equipa de ler especificações técnicas e relatórios extensos. Na partilha, basta fazer upload do ficheiro HTML para a nuvem e partilhar o link, evitando o problema de suporte nativo limitado do Markdown em alguns navegadores.

Fonte da imagem: Thariq Shihipar　Engenheiro do Claude Code defende HTML em substituição ao 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 dúvidas na comunidade, mas o verdadeiro foco deveria ser: quando usar HTML e 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 a geração do formato.

⭐Quem irá ler este documento?

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

The Smart Ape aponta que o HTML contém muitos estilos e etiquetas, consumindo mais de três vezes a quantidade de tokens, além de diluir o sinal semântico, o que reduz a relevância na pesquisa subsequente em cerca de 15% a 25%; no entanto, se o documento for uma única leitura por humanos, um relatório, por exemplo, o HTML pode ser considerado.

⭐Quantas vezes será editado este documento?

Ao editar ficheiros Markdown, a IA normalmente só precisa substituir algumas linhas de texto. 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 um sério “deslocamento de marcações”, com múltiplos sistemas de espaçamento e cores misturados no interior.

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

⭐Qual é a duração do ciclo de vida deste documento?

A durabilidade do arquivo também é uma consideração importante. Após seis meses, os desenvolvedores podem facilmente procurar por conteúdo Markdown específico no projeto usando palavras-chave, enquanto que, em HTML, a pesquisa pode falhar devido à complexidade das estruturas de etiquetas.

Além disso, um documento Markdown de há vários anos ainda pode ser aberto de forma limpa, enquanto um HTML que depende de recursos externos pode perder o estilo ao longo do tempo. Assim, para documentos essenciais de longo prazo, o Markdown deve ser a base.

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 de 30 segundos primeiro

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

Antes de optar pelo HTML, pergunte-se: Este documento consegue ser convertido perfeitamente de volta para um Markdown limpo apenas com uma sugestão de prompt? Se a resposta for não, significa que o conteúdo está demasiado ligado às marcações, e o documento poderá tornar-se 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 futuro com otimismo.

Ele aponta que, ao terminar o prompt pedindo ao LLM para gerar em formato HTML e abrir o ficheiro no navegador, esta abordagem é bastante eficaz na fase atual, tendo ele mesmo conseguido fazer a IA criar apresentações de slides, por exemplo.

Acredita que os humanos, sendo animais visuais, irão passar por várias fases de evolução na forma de saída de conteúdo com o avanço da IA. Até prevê que, no futuro, estas evoluções poderão levar à geração de vídeos interativos ou ambientes simulados diretamente por redes neurais.