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, criar 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 problemas de suporte nativo ao 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, quando usar Markdown?

Um colunista que acompanha 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 afetar 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 este documento será editado?

Ao editar documentos em Markdown, a IA geralmente substitui apenas algumas linhas de texto. Com HTML, ao editar, 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 atualizado, usar Markdown garante maior estabilidade do conteúdo, sendo o HTML mais adequado para a versão final de publicação.

⭐Qual é o ciclo de vida esperado do documento?

A durabilidade do arquivo também é importante. Após seis meses, os desenvolvedores podem facilmente procurar por conteúdo Markdown usando palavras-chave, enquanto que, em HTML, a busca pode falhar devido à complexidade das etiquetas.

Além disso, um documento Markdown de anos atrás ainda pode ser aberto de forma limpa, enquanto um HTML que depende de recursos externos pode perder estilos. 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 para diferentes públicos conforme necessário.

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

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 palavra-chave? Se a resposta for não, significa que o conteúdo está profundamente ligado às marcações, e o documento pode 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 opiniões opostas, o ex-cientista da OpenAI, Andrej Karpathy, vê o futuro com otimismo.

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 já conseguiu fazer a IA criar apresentações de slides, por exemplo.

Acredita que os humanos, sendo animais visuais, irão evoluir na forma de saída de IA, passando por várias fases de melhoria. E até prevê que essa evolução levará a vídeos interativos ou ambientes simulados gerados diretamente por redes neurais.

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

Claude Code+OnlyFans ganha milhares de dólares por mês? Quanto de credibilidade há na história de uma startup de IA com 30 milhões de visualizações?