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.