DevToy

Tabelas Markdown

Alinhamento de tabelas Markdown: esquerda, centro e direita

Entenda como os dois-pontos na linha separadora controlam o alinhamento e quando usar cada opção.

Publicado 11 de julho de 2026 · Atualizado 11 de julho de 2026

O alinhamento de uma tabela Markdown fica na linha separadora, não nas células de dados. Dois-pontos à esquerda alinham à esquerda, nos dois lados centralizam e à direita alinham à direita.

As três formas de alinhamento

| Nome | Status | Duração |
| :--- | :----: | -------: |
| Build | Aprovado | 42 s |
| Deploy | Aguardando | 3 min |

O exemplo usa :---, :---: e ---:. A quantidade de hífens costuma ser flexível, mas três ou mais têm melhor compatibilidade. Espaços adicionais melhoram a leitura do código e geralmente não alteram o resultado.

Escolha conforme o significado

Esquerda é o padrão para nomes, descrições, URLs e texto. Centro funciona para valores curtos como sim/não, ícones ou status. Evite centralizar frases longas. Direita ajuda a comparar preços, quantidades, durações e percentuais. O conteúdo continua sendo texto, sem ordenação ou cálculos de planilha.

Mantenha o código fácil de editar

Preencher células com espaços até a mesma largura é opcional:

| Chave | Valor |
| :-- | ----: |
| A | 10 |

Para alterações frequentes, use um formatador. Ele deve considerar a largura visual de emojis e caracteres CJK, que nem sempre coincide com o comprimento da string JavaScript.

Investigue alinhamento ignorado

Se tudo aparece à esquerda, confira se o destino aceita tabelas GitHub Flavored Markdown; CommonMark sozinho não define tabelas. Cabeçalho e separador devem ter o mesmo número de células, sem barras verticais não escapadas criando colunas extras.

Use o editor de tabelas Markdown para trocar o alinhamento por coluna e inspecionar a linha gerada.

Guias relacionadas