Como fazer tabela no Markdown
Atualizado em 6 de outubro de 2026
Uma tabela em Markdown é feita com barras verticais (|) separando as colunas e uma linha de hifens (---) logo abaixo do cabeçalho. Cada linha do texto vira uma linha da tabela. Para não montar à mão, copie as células do Excel e cole no Conversor de tabela para Markdown.
A estrutura básica
| Produto | Quantidade | Preço |
| ------- | ---------- | -------- |
| Arroz | 2 | R$ 25,90 |
| Feijão | 3 | R$ 8,49 |
- A primeira linha é o cabeçalho.
- A segunda linha é obrigatória: um grupo de hifens para cada coluna, separados por barras.
- As barras nas pontas são opcionais, mas deixam o texto mais fácil de ler.
- Não precisa alinhar as barras. A tabela fica igual com ou sem espaços sobrando; alinhar só ajuda quem lê o texto cru.
Como alinhar as colunas
Os dois-pontos na linha de hifens definem o alinhamento: à esquerda, nos dois lados para centralizar, ou à direita. Números ficam melhor alinhados à direita.
| Esquerda | Centro | Direita |
| :------- | :----: | ------: |
| Arroz | 2 | 25,90 |
Os casos que confundem
- Barra vertical dentro da célula: escreva \|, com a barra invertida antes, para ela não virar divisão de coluna.
- Quebra de linha dentro da célula: o Markdown não tem. No GitHub, dá para usar <br>.
- Célula vazia: deixe só o espaço entre as barras.
- Mesclar células: não existe no Markdown. Repita o valor ou use uma tabela em HTML.
- Tabela sem cabeçalho: o formato exige a linha de cabeçalho. Se não precisar dela, deixe as células do cabeçalho vazias.
Onde a tabela funciona
A tabela não fazia parte do Markdown original, de 2004. Ela veio com o GitHub Flavored Markdown, que virou o padrão de quase todo programa que usa Markdown hoje.
- Funciona: GitHub e GitLab (README, issues e pull requests), Obsidian e outros editores de notas em Markdown, Reddit e as respostas de assistentes como o ChatGPT, que escrevem tabelas assim.
- Não funciona: WhatsApp e Discord não desenham tabelas. Para o WhatsApp, veja como mandar uma tabela pelo WhatsApp.
Do Excel para Markdown sem digitar
- Selecione as células no Excel ou no Google Planilhas e copie com Ctrl+C.
- Cole no Conversor de tabela para Markdown.
- Copie a tabela pronta. Colunas só com números já saem alinhadas à direita.
O caminho contrário também existe: para levar uma tabela Markdown, como a de uma resposta do ChatGPT, para o Excel, use o Conversor de Markdown para Excel.
Perguntas frequentes
Precisa alinhar as barras verticais?
Não. O resultado é o mesmo com ou sem alinhamento. Alinhar só deixa o texto cru mais fácil de ler.
Quantos hifens vão na linha de baixo do cabeçalho?
O GitHub aceita um hífen só por coluna, mas alguns programas pedem três. Use três ou mais para garantir.
Dá para usar negrito e link dentro da célula?
Sim. A marcação normal de negrito, itálico, código e link funciona dentro das células. O que não funciona é quebra de linha e lista.
Por que a minha tabela aparece como texto com barras?
Ou o programa não desenha tabelas em Markdown, ou falta a linha de hifens logo abaixo do cabeçalho, ou há uma linha em branco antes da tabela faltando. Deixe uma linha em branco antes da tabela.