Gerador de Tabela Markdown — CSV/TSV para Markdown

Cole os dados delimitados que você já tem — exportação de planilha, saída de um script, um trecho de CSV — e receba uma tabela em GitHub-Flavored Markdown pronta para colar. A ferramenta reconhece o delimitador sozinha, respeita campos entre aspas segundo a RFC 4180 e neutraliza os dois caracteres que quebrariam a tabela: a barra vertical e a quebra de linha dentro da célula. As colunas saem preenchidas até a mesma largura, então o Markdown bruto continua legível no editor e no diff.

O que é o Gerador de Tabela Markdown

O Gerador de Tabela Markdown converte dados delimitados — CSV ou TSV — em uma tabela no formato GitHub-Flavored Markdown, pronta para colar em um README, numa issue ou na documentação do projeto. A leitura segue a RFC 4180, então campos entre aspas, aspas duplas escapadas e quebras de linha dentro das aspas são interpretados corretamente, e não como novos campos ou novas linhas. A saída vem com todas as colunas preenchidas até a mesma largura, o que mantém o Markdown bruto legível antes mesmo de ser renderizado.

Como funciona o gerador de tabelas

O texto colado é analisado por um leitor conforme a RFC 4180 e não por um split ingénuo: um campo entre aspas pode conter o delimitador, uma quebra de linha ou aspas duplicadas que representam uma aspa literal. Se deixar o delimitador em automático, a primeira linha é examinada à procura de tabulações, pontos e vírgulas e vírgulas, e vence o mais frequente. Cada célula é depois escapada para Markdown: uma barra vertical solta passa a \| e as quebras de linha internas viram um espaço, porque uma linha de tabela GFM tem de caber numa só linha. Por fim, cada coluna é preenchida até à largura da sua célula mais longa, para que o Markdown em bruto continue legível num diff, embora o preenchimento não altere a tabela renderizada.

Recursos

Parser conforme a RFC 4180: aspas, aspas duplas escapadas dentro do campo e quebras de linha entre aspas são tratadas corretamente.

Detecção automática do delimitador a partir da primeira linha, testando tabulação, ponto e vírgula e vírgula — com opção de fixar manualmente.

Escape de barras verticais como \| e achatamento de quebras de linha internas, para que nenhuma célula quebre a estrutura da tabela.

Colunas preenchidas até a mesma largura e linha separadora conforme o alinhamento escolhido: --- , :-: ou --: .

Como usar

Cole ou digite seus dados CSV/TSV no campo de entrada, uma linha por registro.

Deixe o delimitador em detecção automática ou escolha vírgula, ponto e vírgula ou tabulação se a primeira linha for ambígua.

Escolha o alinhamento das colunas — à esquerda, centralizado ou à direita — e marque se a primeira linha é o cabeçalho.

Copie a tabela em Markdown gerada e confira as observações, que apontam ajustes feitos nas células, como pipes escapados.

Erros comuns

Colar dados cujo primeiro registro não representa o resto do arquivo: a detecção olha só a primeira linha, então fixe o delimitador quando ela for atípica.

Esperar que uma célula com várias linhas continue com várias linhas — quebras internas são achatadas, porque o Markdown não aceita quebra dentro de uma célula.

Deixar a opção de cabeçalho marcada quando os dados começam direto nos valores, o que transforma o primeiro registro em título das colunas.

Exemplos

nome,idade ⏎ Ana,31 → | nome | idade | ⏎ | ---- | ----- | ⏎ | Ana | 31 |

"Silva, Ana",31 → | Silva, Ana | 31 | (a vírgula entre aspas não separa campos)

Veja também

CSV para JSON — Quer as mesmas linhas como dados estruturados em vez de uma tabela? Converta para JSON.
Remover espaços — Espaços à esquerda perdidos vão aparecer em todas as células — retire-os primeiro.

Perguntas frequentes

Como o delimitador é detectado?

A detecção analisa apenas a primeira linha dos dados e testa, nessa ordem, tabulação, ponto e vírgula e vírgula. Se a primeira linha não for representativa do arquivo, escolha o delimitador manualmente no seletor.

O que acontece se meus dados tiverem uma barra vertical?

Toda barra vertical dentro de uma célula é escapada como \|. Sem isso, o Markdown interpretaria o caractere como separador de coluna e a linha inteira ficaria desalinhada ao ser renderizada.

Campos entre aspas com vírgulas ou quebras de linha funcionam?

Sim. O parser segue a RFC 4180: aspas delimitam o campo, duas aspas duplas seguidas representam uma aspa literal e quebras de linha entre aspas não encerram o registro. As quebras de linha internas, porém, são achatadas na saída, já que o Markdown não permite quebra dentro de uma célula.

Por que a tabela sai com tantos espaços?

Cada coluna é preenchida com espaços até a largura da célula mais longa. Isso não muda nada no resultado renderizado, mas mantém o Markdown bruto alinhado e legível — inclusive no diff de um pull request.