# Tabelas em Markdown

> As tabelas podem perder a estrutura quando documentos são convertidos ou enviados a ferramentas de IA. Aprenda a explicitar linhas e colunas e confira o resultado na ferramenta de destino.

## 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% |
```

| Metric | Q2 | Q3 |
|---|---|---|
| Retention | 91% | 95% |
| Churn | 2.4% | 2.1% |

## Por que uma estrutura explícita pode ajudar

As barras e os cabeçalhos tornam explícitos os limites pretendidos de linhas e colunas. Isso pode reduzir a ambiguidade em comparação com os mesmos dados achatados em texto corrido, mas não garante que um modelo preserve todas as relações. Teste tabelas complexas com dados representativos no conversor, editor ou ferramenta de IA que você pretende usar.

:::tip
**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.
:::

:::caution
**Não ideal para:** tabelas muito aninhadas ou mescladas. Se a origem tem cabeçalhos mesclados, até boas ferramentas precisarão de ajuste manual.
:::