Gerador de Tabela Markdown

Gerador online gratuito de tabela Markdown com editor visual estilo planilha. Crie, edite e formate tabelas Markdown facilmente. Suporte a alinhamento de coluna, formatação elegante e prévia instantânea. Perfeito para README do GitHub, documentação e posts de blog.

Tem feedback? Reporte bugs, sugira recursos ou compartilhe suas ideias — lemos todos

Gerador de Tabela Markdown - Criador Visual de Tabelas

Um poderoso gerador de tabela Markdown com editor visual estilo planilha. Crie e formate tabelas facilmente com alinhamento de coluna, formatação elegante e prévia instantânea. Gere tabelas Markdown compatíveis com GitHub para arquivos README, documentação, wikis e posts de blog.

Qual é a sintaxe básica de tabela Markdown?

Tabelas Markdown usam barras verticais (|) para separar colunas e pelo menos três hifens (---) para definir a linha de cabeçalho. As especificações CommonMark e GitHub Flavored Markdown (GFM) concordam na estrutura: linha de cabeçalho, linha separadora, linhas de dados. Exemplo: `| Nome | Idade |\n|---|---|\n| Alice | 30 |`. Barras inicial e final são opcionais mas melhoram a legibilidade. O alinhamento é controlado por dois-pontos na separadora: `:---` esquerda, `:---:` centro, `---:` direita. Note que o CommonMark puro (RFC 7763) não inclui tabelas; tabelas são extensão do GFM, disponíveis na maioria dos renderizadores modernos como Pandoc, MkDocs e Hugo.

Como alinho colunas à esquerda, direita ou centro?

Coloque dois-pontos na linha separadora para definir alinhamento por coluna. `:---` alinha à esquerda (padrão), `---:` à direita (bom para números), `:---:` centraliza (bom para cabeçalhos ou símbolos). Exemplo: `| Item | Preço |\n|:---|---:|\n| Maçã | R$ 1,50 |` produz coluna Item à esquerda e coluna Preço à direita. Alguns renderizadores ignoram dicas de alinhamento ao exportar para texto puro ou terminal; só fazem efeito em HTML ou PDF. Teste no renderizador alvo porque GitHub, GitLab e Bitbucket renderizam alinhamento de forma ligeiramente diferente entre temas mobile e desktop.

Posso incluir barras (|) dentro de células?

Sim — escape as barras dentro do conteúdo da célula com contrabarra: `\|`. A spec CommonMark GFM seção 4.10 exige esse escape. Exemplo: `| Regex | Descrição |\n|---|---|\n| \\| | Alternação |` exibe uma barra literal na primeira coluna. Entidades HTML (`|`) também funcionam na maioria dos renderizadores. Para conteúdo complexo com muitos caracteres especiais (padrões regex, blocos de código contendo barras), considere mudar para a sintaxe `<table>` HTML — Markdown permite HTML cru dentro de sua fonte, e tabelas HTML podem conter qualquer caractere sem escape. Muitos geradores de sites estáticos os convertem automaticamente por acessibilidade.

Como adiciono quebras de linha ou parágrafos dentro de uma célula?

Tabelas Markdown não suportam células multilinha nativamente porque a sintaxe de linha é definida por quebras de linha. Use a tag HTML `<br>` para quebras de linha dentro de uma célula: `| Item | Notas |\n|---|---|\n| Maçã | Vermelha<br>Doce |`. Para parágrafos, listas ou blocos de código dentro de células, recorra a HTML cru: `<td><p>Primeiro</p><p>Segundo</p></td>`. A variante Pandoc Markdown suporta tabelas pipe com conteúdo multilinha via `--from=markdown_strict+pipe_tables+multiline_tables`, mas a maioria das ferramentas (GitHub, Stack Overflow, Reddit) segue GFM estrito e colapsa o conteúdo da célula em uma única linha.

Gerador de Tabela Markdown — Gerador online gratuito de tabela Markdown com editor visual estilo planilha. Crie, edite e formate tabelas Markdown fac — **Gerador de Tabela Markdown**

Qual a diferença entre tabelas pipe e tabelas grid?

Tabelas pipe (sintaxe comum) usam barras verticais e hifens. Tabelas grid (Pandoc, reStructuredText) usam arte ASCII completa com cantos `+` e linhas separadoras `=`/`-`, permitindo células multilinha e larguras variadas. Exemplo grid:
```
+------+-------+
| Nome | Valor |
+======+=======+
| A | 1 |
+------+-------+
```
Tabelas grid são mais poderosas mas só são suportadas por Pandoc, asciidoctor e alguns renderizadores RST — não GitHub ou CommonMark genérico. Para máxima compatibilidade prefira pipe; para documentação técnica com conteúdo rico, as grid são excelentes. O capítulo de tabelas do manual Pandoc compara em detalhe os quatro tipos suportados.

Como converto dados CSV ou Excel em tabela Markdown?

Várias ferramentas automatizam essa conversão: o Markdown Table Generator deste site aceita CSV colado e produz saída formatada. Pandoc converte com `pandoc entrada.csv -o saida.md --to=markdown`. Programaticamente: leia o CSV com o módulo `csv` do Python ou o método `df.to_markdown()` do pandas (requer o pacote `tabulate`). Para Excel, salve como CSV primeiro ou use openpyxl/pandas para ler direto. Cuidado com caracteres especiais — barras, contrabarras e HTML no conteúdo da célula precisam de escape. Apare também espaços ao final de cada linha e garanta que cada linha tenha o mesmo número de colunas do cabeçalho, ou alguns renderizadores truncarão ou deformarão a tabela em silêncio.

Por que minha tabela não renderiza em alguns visualizadores Markdown?

Causas comuns: falta da linha separadora (a linha de hifens é obrigatória), contagem inconsistente de colunas entre linhas, sem linha em branco antes da tabela ou uso de renderizador CommonMark puro que não habilita a extensão de tabelas GFM. A seção 4 da CommonMark Spec lista tabelas como 'não parte do core' — implementações como markdown-it, Showdown e Marked exigem extensão ou plugin explícito. Verifique também se o arquivo usa quebras LF (não CRLF Windows ou CR Mac), porque alguns parsers contam retornos de carro como parte do conteúdo da célula. Em caso de dúvida, cole sua fonte na pré-visualização do README do GitHub como renderizador de referência.

Há considerações de acessibilidade para tabelas Markdown?

Sim — tabelas HTML bem formadas incluem `<caption>`, `<thead>` e `<th scope="col">` para leitores de tela conforme WCAG 2.1 SC 1.3.1 e a especificação ARIA tables. Tabelas Markdown geram `<table>`, `<thead>`, `<tbody>`, `<tr>`, `<td>` e `<th>` básicos, mas carecem de caption ou atributo scope. Para documentação acessível use HTML cru em tabelas complexas: `<table><caption>Vendas Anuais</caption><thead><tr><th scope="col">Ano</th></tr></thead>...</table>`. Evite usar tabelas para layout; use-as apenas para dados tabulares com relação lógica linha-coluna. Tabelas longas se beneficiam de cabeçalhos de grupo de linhas (`<tbody>` com `<th scope="rowgroup">`), que o Markdown não consegue expressar.