Tabelas em Markdown
As tabelas são onde os documentos mais quebram quando uma IA os lê. Veja como escrevê-las para a estrutura sobreviver — e como identificar uma tabela achatada em ruído.
~4 min
GFM
Atualizado jun 2026
Sintaxe básica
Uma tabela são apenas barras e hífens: uma linha de cabeçalho, um divisor de hífens e seus dados. Os dois-pontos no divisor definem o alinhamento das colunas.
markdown
| Metric | Q2 | Q3 | |:----------|-----:|-----:| | Retention | 91% | 95% | | Churn | 2.4% | 2.1% |
:--- left · ---: right · :--: center
Resultado renderizado
| Metric | Q2 | Q3 |
|---|---|---|
| Retention | 91% | 95% |
| Churn | 2.4% | 2.1% |
Por que a IA lê melhor
Quando as barras se alinham, o modelo interpreta linhas e colunas como relações reais. Achate os mesmos dados em texto corrido e o modelo terá de adivinhar qual número pertence a qual métrica.
Dica. Um dado por célula. Células mescladas e de várias linhas são a causa mais comum de tabelas quebrarem na conversão.
Não ideal para: tabelas muito aninhadas ou mescladas. Se a origem tem cabeçalhos mesclados, até boas ferramentas precisarão de ajuste manual — veja o benchmark de tabelas PDF.