← Voltar pro acervo

Patterns & Práticas · 10 mai 2026

Markdown é o default.
HTML é o salto.

Toda spec técnica que o agente entrega hoje vira parede de texto. HTML carrega 8 tipos de informação num único arquivo, Markdown carrega 1. Esse kit te entrega 3 templates HTML standalone, mapa de decisão em 5 cenários, e o prompt pra fazer Claude/Cursor/Codex escolherem o formato sozinhos.

Decifrado a partir de Thariq (@trq212), engenheiro da Anthropic — ensaio "The Unreasonable Effectiveness of HTML" · 10.05.2026.

Arquivos · 7 docs

O que tem aqui dentro

comece pelo 04 se quer aplicar agora

Índice e ordem de leitura

Mapa do kit. A regra que sobra: Markdown é o que o agente escreve. HTML é o que o cliente lê.

01-os-8-tipos-de-info.md

Os 8 tipos de informação que HTML carrega

Tabelas com destaque, cor + hierarquia, SVG inline, syntax highlight, interação, diagramas, espaço cartesiano, imagens base64. Comparação direta com Markdown (1 vence 8).

02-mapa-decisao-md-vs-html.md

Mapa de decisão · 5 cenários

Spec pra cliente, diff em PR, share com não-dev, iteração com agente, relatório com chart. Quem vence cada um. Tabela de decisão rápida pra 10 cenários comuns.

03-tres-templates-html.md

3 templates HTML standalone

Page (spec/doc linear), Doc técnica (com TOC + code-heavy), Dashboard (KPIs + chart). CSS inline, zero dependência, prontos pra colar no projeto.

04-prompt-para-claude-escolher.md

Prompt pra Claude Code / Cursor / Codex escolherem sozinhos

2 versões (curta paste-and-go + completa com critérios). Cola no CLAUDE.md / .cursorrules / .codex/instructions. Agente passa a escolher MD ou HTML conforme o cenário detectado.

05-custo-token-honesto.md

Custo em token: o trade-off honesto

HTML gasta 2-4× mais tokens. Quando vale (entrega final, doc recorrente, pitch) e quando NÃO vale (iteração, rascunho). 4 mitigações práticas (convert at the end, templates, modelo barato, modelo local).

Thariq Anthropic, leituras complementares, panorama

Origem do ensaio, contexto Anthropic, tese resumida. Leituras pra filosofia (Worse is Better, Markdown Mark), agentes (Artifacts, v0, Bolt), custo (tokenizer, OpenRouter).