Conversor de tabela Markdown para CSV
Converte uma tabela Markdown (`| col1 | col2 |`) em CSV ou TSV. Útil para trazer tabelas exportadas do GitHub Wiki, Notion ou Confluence para o Excel ou uma planilha. A conversão ocorre inteiramente no navegador; nenhum dado é enviado a um servidor.
| Delimitador de saída |
|
|---|---|
| Incluir a linha de cabeçalho na saída |
Digite uma tabela Markdown para ver aqui o CSV gerado.
Como uma linha de tabela Markdown corresponde a uma linha CSV
| Uma linha Markdown | | name | age | city | |
|---|---|
| Linha CSV resultante | name,age,city |
A linha delimitadora logo após o cabeçalho (`---`, `:---`, `:---:` ou `---:`) é ignorada em vez de tratada como dado. Qualquer barra vertical escapada (`\|`) dentro de uma célula é restaurada como um caractere "|" comum.
O que é a conversão de tabela Markdown para CSV
Tabelas criadas em ferramentas de documentação — wikis, notas colaborativas, bases de conhecimento — são práticas para ler, mas assim que você precisa somar valores, filtrar linhas ou cruzar informações, acaba tendo que levá-las para uma planilha. Esta ferramenta interpreta a sintaxe de tabela do Markdown e a transforma em CSV ou TSV em poucos segundos, sem que você precise copiar célula por célula ou reescrever separadores manualmente. A linha delimitadora que aparece logo abaixo do cabeçalho é detectada e descartada automaticamente, de modo que o resultado final contém apenas as linhas que realmente são dados.
A ferramenta segue a sintaxe de tabela do GitHub Flavored Markdown (GFM), reconhecendo tanto as linhas que começam e terminam com uma barra vertical (`| a | b |`) quanto as que omitem essa barra nas extremidades. Ela também cuida dos detalhes chatos do formato CSV: se um valor contém vírgula, quebra de linha ou aspas duplas, ele é automaticamente envolvido em aspas para que nenhuma planilha interprete o conteúdo de forma errada. Por outro lado, se o texto colado não tiver uma linha delimitadora reconhecível, a entrada não é tratada como uma tabela válida e nenhum resultado é gerado — por isso vale conferir se o Markdown original mantém essa linha de hifens.
Como converter uma tabela Markdown em CSV
- Cole a tabela Markdown Copie o bloco de tabela inteiro do seu documento — incluindo a linha de hifens abaixo do cabeçalho — e cole no campo de entrada.
- Escolha o delimitador de saída Selecione vírgula para obter um CSV padrão, ou tabulação se for colar o resultado diretamente no Excel ou no Google Planilhas, onde o TSV costuma manter as colunas melhor alinhadas.
- Decida se o cabeçalho entra na saída Se preferir tratar os nomes das colunas separadamente, desmarque a opção correspondente e a saída trará apenas as linhas de dados.
- Copie ou baixe o resultado Use o botão de copiar para colar onde precisar, ou salve como arquivo `.csv` para importar no seu programa de preferência.
Dicas para aproveitar melhor
- A linha delimitadora logo após o cabeçalho é detectada e ignorada automaticamente, então `---`, `:---` (esquerda), `:---:` (centro) e `---:` (direita) são convertidos sem problema, seja qual for o alinhamento.
- Ao desativar "Incluir a linha de cabeçalho na saída", é gerado um CSV contendo apenas as linhas de dados, sem o cabeçalho — útil quando você quer gerenciar o cabeçalho separadamente.
- Se o valor de uma célula contiver vírgula ou aspas duplas, ele é automaticamente envolvido em aspas duplas conforme as regras do CSV, com qualquer `"` interna escapada como `""`.
- Combine isso com o conversor de CSV para tabela Markdown para converter entre CSV e tabelas Markdown quantas vezes precisar.
Para que serve converter Markdown em CSV
Analisar listas de documentação
Leve tabelas mantidas em um wiki interno ou em notas colaborativas para uma planilha, onde é possível ordenar, filtrar ou calcular totais que o Markdown sozinho não resolve.
Transformar um README em dados utilizáveis
Tabelas de compatibilidade, parâmetros de configuração ou comparativos de versões viram um CSV que um script consegue ler para validações ou geração automática de documentação.
Extrair pendências de uma ata de reunião
Uma tabela de tarefas escrita em Markdown durante uma reunião é convertida em um formato que pode ser importado diretamente em uma ferramenta de gestão de tarefas.
Ir e voltar entre os formatos sem esforço
Combinada com o conversor de CSV para tabela Markdown, você pode partir de qualquer um dos dois formatos e alternar para o outro quantas vezes precisar durante a edição.
Glossário de Markdown e CSV
- Sintaxe de tabela
- A forma como o Markdown representa uma tabela alinhando células separadas por barras verticais. Diferente do CSV, ela inclui uma linha de cabeçalho e uma linha delimitadora que marcam a estrutura visualmente.
- Linha delimitadora
- A linha de hifens (`---`) colocada logo abaixo do cabeçalho. Ao renderizar a tabela, ela aparece como uma linha divisória, mas não é um dado — por isso é descartada automaticamente na conversão.
- GFM
- Sigla de GitHub Flavored Markdown, a variante de Markdown usada no GitHub e adotada como referência por muitas outras plataformas. Permite omitir as barras verticais no início e no fim de cada linha.
- TSV
- Um formato de texto tabular que separa os valores com tabulações em vez de vírgulas. É útil quando os dados já contêm vírgulas ou ao colar diretamente em uma planilha, pois reduz o risco de as colunas ficarem desalinhadas.
- Aspas em CSV
- A regra que envolve um valor em aspas duplas quando ele contém vírgula, quebra de linha ou aspas. Qualquer aspas dupla dentro do valor é duplicada (`""`) para que o arquivo continue válido.
Perguntas frequentes
Curiosidade — o que realmente diferencia uma tabela Markdown de um CSV
CSV e tabelas Markdown são duas formas de representar dados tabulares como texto, mas servem a propósitos diferentes. CSV é um formato legível por máquina, pensado para ser lido e escrito por programas — planilhas, bancos de dados e afins —, enquanto uma tabela Markdown é uma notação voltada para documentação que prioriza que uma pessoa consiga olhar o código-fonte e ainda assim distinguir aproximadamente o formato da tabela.
É por isso que uma tabela Markdown tem conceitos que o CSV não tem: uma linha de cabeçalho e uma linha delimitadora (`---`). Visualmente, essa linha delimitadora é renderizada como uma linha divisória, mas no código-fonte não passa de uma sequência de hifens — uma notação específica do Markdown que existe apenas para dizer ao analisador que "tudo acima disso é cabeçalho, tudo abaixo é dado".
Querer mover uma tabela criada em uma ferramenta de documentação como GitHub Wiki, Notion ou Confluence para uma planilha é algo que surge com frequência ao organizar atas de reuniões de equipe ou um README. Ter esta ferramenta ao lado de sua contraparte — de CSV para tabela Markdown — permite começar a partir de qualquer um dos dois formatos e converter sem hesitação.