Gerador de Tabela Markdown

Sintaxe da tabela Markdown

Tabela básica:

| Coluna A | Coluna B | Coluna C |
|----------|----------|----------|
| célula 1   | célula 2   | célula 3   |
| célula 4   | célula 5   | célula 6   |

O alinhamento usa dois pontos na linha de separador:

| Esquerda | Centro | Direita |
|:-----|:------:|------:|
| a    | b      | c     |

• :--- alinha à esquerda
• :---: alinha ao centro
• ---: alinha à direita

O que o gerador faz por você

• Preenche cada célula para a largura da entrada mais longa em sua coluna, de modo que os pipes se alinhem na fonte. Não afeta a saída renderizada, o Markdown ignora espaços extras, mas os humanos que leem o diff vão agradecer.
• Escapa pipes dentro das células como \| para que uma célula contendo a|b não se divida em duas colunas.
• Preserva o alinhamento quando você altera as larguras das colunas.
• Aceita colagem de CSV e TSV; detecta campos entre aspas e vírgulas dentro de aspas.

Armadilhas comuns

• Linha de separador é obrigatória. Tabelas Markdown sem a linha |---|---| são renderizadas como texto simples.
• Sem células de múltiplas linhas. Cada linha é uma linha; insira <br> se precisar de uma quebra interna, já que quebras de linha em células de tabela não são suportadas no Markdown.
• Sem tabelas aninhadas. Se você precisar delas, volte para HTML.
• Células vazias precisam de um espaço (ou pelo menos um par vazio de pipes). Evite || diretamente.

Quando usar HTML em vez disso

Se você precisar de colspan, rowspan, células de múltiplas linhas ou classes CSS personalizadas, tabelas HTML são a ferramenta certa. A maioria dos analisadores Markdown aceita marcação de tabela HTML bruta inline.

Onde tabelas Markdown funcionam bem

• GitHub, GitLab, Gitea READMEs.
• Descrições de problemas e PRs.
• Obsidian, Bear e a maioria dos aplicativos de anotações.
• Docusaurus, MkDocs, Hugo, todos suportam tabelas GFM.