Converter CSV para tabela Markdown
Digitar uma tabela Markdown à mão significa contar pipes e traços em cada linha. Envie o CSV e receba uma tabela com linha de cabeçalho e linha delimitadora, pronta para colar num README, numa página de wiki ou num notebook.
Conversor de dados
ou solte arquivos CSV, TSV, TXT … aqui ·
Até 95 MB por arquivo· Até 20 arquivos· Apagados após 30 minutos
Os arquivos são processados em nossos servidores e apagados após 30 minutos.
Caractere que separa as colunas em arquivos CSV e de texto, tanto na leitura quanto na escrita. A detecção automática identifica o da entrada e grava vírgulas.
UTF-8 funciona para qualquer idioma. Escolha UTF-8 com BOM se o Excel no Windows mostrar acentos ou caracteres asiáticos embaralhados ao abrir o CSV.
Entrada Excel, ODS e Numbers: converta só a primeira planilha ou todas (um CSV por planilha em um ZIP, ou uma chave JSON por planilha).
Nome da aba na nova planilha, com até 31 caracteres.
Array de objetos usa os nomes das colunas como chaves em cada linha; array de arrays é mais compacto e mantém o cabeçalho como primeiro array.
Nome do elemento externo que envolve todas as linhas; cada linha vira um <row> dentro dele.
Usado nos comandos CREATE TABLE e INSERT. Somente letras, dígitos e sublinhados.
As aspas e os tipos de coluna variam um pouco entre bancos de dados; escolha aquele em que você vai importar.
Reescreve as células de data em um único formato. ISO (2026-10-18) é o mais seguro para bancos de dados e código; manter como está deixa as datas como aparecem no original.
Como usar esta ferramenta
- 1
Envie o CSV
Adicione arquivos .csv, .tsv ou .txt delimitados, até 20 de uma vez e 95 MB cada. A detecção automática reconhece vírgulas, ponto e vírgula, tabulações e pipes.
- 2
Confirme o cabeçalho
Primeira linha é cabeçalho vem ativado, então a linha 1 vira o cabeçalho da tabela. Desative em Configurações avançadas se o arquivo já começa com dados.
- 3
Converta e cole
Clique em Converter para Tabela Markdown, abra o arquivo .md e cole a tabela no README, no pull request, na issue ou na nota.
Como transformar um arquivo CSV em tabela Markdown?
Envie o CSV e clique em Converter para Tabela Markdown. A primeira linha vira o cabeçalho da tabela, uma linha de traços é adicionada abaixo dela e cada uma das outras linhas vira uma linha com células separadas por pipes.
Por que desenvolvedores convertem CSV em Markdown
A documentação vai parar cada vez mais em arquivos Markdown. Um mantenedor quer uma tabela de versões suportadas no README, uma engenheira cola números de benchmark num pull request, um pesquisador mantém uma lista de leitura no Obsidian. Os números quase sempre nascem numa planilha ou na saída CSV de um script, e reconstruí-los à mão, com um pipe entre cada célula, é lento e fácil de errar.
O Markdown original de John Gruber, de 2004, não tinha tabelas. A sintaxe com pipes se espalhou pelo PHP Markdown Extra e entrou na especificação do GitHub Flavored Markdown em 2017, por isso funciona no GitHub e na maioria das ferramentas que seguem esse padrão. Se as linhas vieram do Excel, salve-as primeiro com Excel para CSV e depois converta aqui.
Exemplo de CSV convertido em tabela Markdown
runtime,versão,status Python,3.13,suportado Python,3.9,fim do suporte | outubro de 2025 Node.js,22,suportado
| runtime | versão | status | | --- | --- | --- | | Python | 3.13 | suportado | | Python | 3.9 | fim do suporte \| outubro de 2025 | | Node.js | 22 | suportado |
Onde uma tabela Markdown convertida aparece
| Órgão | Exigência | Fonte |
|---|---|---|
| GitHub | Renderiza tabelas com pipes em READMEs, issues, pull requests e wikis, seguindo a especificação GFM. | Especificação GFM |
| GitLab | O GitLab Flavored Markdown renderiza as mesmas tabelas com pipes em repositórios, issues e merge requests. | — |
| Obsidian | Mostra tabelas com pipes no modo de leitura e permite editá-las na prévia ao vivo. | — |
| Jupyter | As células Markdown dos notebooks renderizam tabelas com pipes ao lado do seu código. | — |
| CommonMark | A especificação central não tem sintaxe de tabela; os renderizadores precisam de uma extensão de tabelas. | commonmark.org |
Fatos sobre os formatos CSV e Markdown
CSV
Valores separados por vírgula (CSV)
CSV é um formato de texto simples para tabelas em que cada linha é um registro e vírgulas separam as colunas. É usado desde os primórdios da computação e está descrito na RFC 4180, embora muitas variantes usem ponto e vírgula ou tabulações e codificações de texto diferentes. Praticamente toda planilha, banco de dados e ferramenta de análise consegue importá-lo e exportá-lo, o que o torna o formato padrão para mover dados entre sistemas. O CSV guarda só valores, sem fórmulas, formatação, várias abas ou tipos de dados.
- Compressão
- –
- Transparência
- –
- Animação
- –
- Lançamento
- –
MD
Markdown
Markdown é uma sintaxe de marcação leve criada por John Gruber em 2004. Ela usa símbolos de texto simples, como # para títulos, * para ênfase e - para listas, que continuam legíveis como texto bruto e se convertem de forma limpa em HTML. É o padrão em arquivos README, documentação, wikis, aplicativos de notas e muitos geradores de sites estáticos. Existem vários dialetos, como CommonMark e GitHub Flavored Markdown, que diferem em detalhes como tabelas. Qualquer editor de texto abre arquivos .md.
- Compressão
- –
- Transparência
- –
- Animação
- –
- Lançamento
- 2004 · John Gruber
Um CSV vira Markdown quando um pequeno conjunto de dados precisa morar dentro da documentação: a tabela de compatibilidade de um README, a lista de versões de um changelog, um pull request comparando benchmarks ou uma nota numa base de conhecimento pessoal.
A conversão é quase sem perdas para os valores, mas não para a intenção. O CSV guarda cada linha para um programa ler; uma tabela Markdown é um retrato dos dados para pessoas, sem tipos, sem fórmulas e sem como mesclar células. Mantenha o CSV no repositório como fonte e gere a tabela de novo quando os números mudarem.
Perguntas sobre CSV para Markdown
Onde uma tabela Markdown convertida de CSV é exibida?
Onde o renderizador suportar a extensão de tabelas com pipes: GitHub, GitLab, Obsidian, notebooks Jupyter e geradores de sites estáticos como MkDocs e Hugo. Um renderizador estritamente CommonMark mostra as mesmas linhas como texto simples, com os pipes visíveis.
E se um valor do meu CSV tiver o caractere pipe?
Um | sem escape iniciaria uma nova célula e empurraria todas as colunas para a direita. O conversor o escreve como \|, o escape definido pelo GitHub Flavored Markdown, então o pipe aparece como texto dentro da célula.
Dá para alinhar números à direita numa tabela Markdown?
Sim, editando a linha delimitadora: ---: alinha a coluna à direita, :---: centraliza e :--- alinha à esquerda. Acrescente os dois-pontos depois de converter; eles mudam só a exibição da tabela, não os dados.
Qual o tamanho de CSV que faz sentido virar tabela Markdown?
Tabelas Markdown são feitas para leitura, então algumas dezenas de linhas e poucas colunas funcionam melhor. Uma tabela com milhares de linhas é convertida sem problema, mas deixa o README difícil de rolar; nesse caso, coloque um link para o arquivo CSV no repositório e mostre uma amostra.
O que acontece com quebras de linha dentro de um campo do CSV?
Uma linha de tabela Markdown precisa ficar numa única linha, então um valor CSV entre aspas que ocupa várias linhas não pode ser mantido como está. Substitua essas quebras antes de converter; no GitHub você pode usar <br> dentro de uma célula para forçar uma.
Posso converter o CSV em tabela HTML em vez de Markdown?
Se o destino for uma página web, um CMS ou um e-mail em vez de um arquivo Markdown, defina Converter para como Tabela HTML. Para dados que começam em JSON, a página JSON para HTML já vem com essa saída selecionada.