Converter CSV para Markdown

1. 1

   Solte o CSV

   Arraste um arquivo .csv, .tsv, .txt ou .psv para a página, ou procure-o. O delimitador, o caractere de aspas e a codificação são lidos do próprio arquivo, e a ferramenta informa o que escolheu.

2. 2

   Confira a pré-visualização renderizada

   A pré-visualização mostra a tabela como ela será renderizada, não apenas o texto bruto — então você vê de imediato se uma célula com um asterisco ou uma quebra de linha vai se comportar.

3. 3

   Ajuste alinhamento e formatação

   Escolha um alinhamento para a tabela toda ou por coluna, pelo cabeçalho da pré-visualização. Ative a saída alinhada para um texto bruto legível, o escape para células com caracteres Markdown, linhas numeradas, ou primeira linha ou coluna em negrito.

4. 4

   Copie ou baixe

   Clique em Converter e depois em Copiar para levar a tabela para a área de transferência, para um README ou um pull request — ou baixe-a como arquivo .md com o nome que quiser. Tudo roda no seu dispositivo.

Converta CSV em uma tabela Markdown no estilo GitHub, com as duas coisas que decidem se o resultado é utilizável: escape correto e controle de como cada coluna se alinha. Use a primeira linha como cabeçalho ou gere rótulos de coluna, defina o alinhamento para a tabela ou por coluna, alinhe a saída ou mantenha-a compacta, e veja a tabela renderizada ao lado do Markdown bruto antes de copiar.

• Formato de tabela Markdown — Markdown no estilo GitHub: uma linha de cabeçalho, uma linha separadora que carrega o alinhamento e uma linha por registro. Renderiza no GitHub, GitLab, Obsidian, Notion, VS Code, Jira e Confluence sem mudanças.
• Alinhamento por coluna — Defina um padrão para a tabela e substitua qualquer coluna pelo menu no cabeçalho dela na pré-visualização. Esquerda, centro, direita ou nenhum.
• Primeira linha como cabeçalho — Use a primeira linha do CSV como cabeçalho, ou desative para tratar todas as linhas como dados com rótulos Col 1, Col 2 gerados.
• Um escape que aguenta — Barras verticais e barras invertidas são sempre escapadas, quebras de linha dentro de uma célula viram <br>, e asteriscos, sublinhados, crases, colchetes, sinais de menor/maior e tis também podem ser escapados.
• Alinhada ou compacta — Alinhe todas as colunas para o arquivo bruto ficar certinho num editor de texto, ou mantenha-o compacto para que uma tabela regerada produza o menor diff possível.
• Pré-visualização renderizada e visão bruta — Veja a tabela como ela será renderizada e o Markdown como ele será escrito, e alterne entre os dois. Cada ajuste muda pelo menos um deles.
• Copiar ou baixar — Leve a tabela direto para a área de transferência, para um README ou um pull request, ou baixe-a como arquivo .md com o nome que escolher.

Uma tabela Markdown são três tipos de linha, e saber qual é qual explica todas as opções desta página. A ferramenta escreve as três por você, mas vale entender o formato porque é ele que decide onde uma tabela quebra.

O cabeçalho e o separador

• Linha de cabeçalho — Uma linha de células entre barras verticais. Ela sempre é renderizada em negrito, por isso colocá-la em negrito de novo não faz nada e por isso as opções de negrito desta ferramenta se aplicam ao corpo.
• Linha separadora — A linha de traços logo abaixo do cabeçalho. Não é enfeite: é a presença dela que faz do bloco uma tabela, e os dois-pontos nela são a única forma de definir o alinhamento.
• Linhas de dados — Uma linha por registro. Uma linha com menos células que o cabeçalho é preenchida; uma com mais seria truncada pela maioria dos renderizadores, então arquivos irregulares são ajustados à linha mais larga.

As duas coisas que quebram uma tabela

• Uma barra vertical sem escape — Uma barra vertical dentro de uma célula encerra essa célula cedo demais, a linha ganha uma coluna e o renderizador desloca ou perde os dados. Esta ferramenta escapa todas as barras verticais, sempre — não é opção porque não existe caso em que o caractere bruto era o que você queria.
• Uma quebra de linha dentro de uma célula — Uma linha de tabela Markdown é uma linha só. Um campo CSV entre aspas com uma quebra — um endereço postal, um comentário — encerraria a linha no meio e todas as linhas seguintes cairiam fora da tabela. Veja a seção de quebras de linha abaixo para as três formas como a ferramenta lida com isso.

O alinhamento vive na linha separadora, como dois-pontos. Esta ferramenta o escreve por você, e ele pode variar por coluna — que é o que se quer no momento em que uma tabela mistura rótulos com números.

• Esquerda — :--- — O padrão, e o certo para nomes, rótulos e texto livre. Dois-pontos à esquerda dos traços.
• Centro — :---: — Dois-pontos dos dois lados. Útil para colunas de status curtas e marcas de um caractere só, em que centralizar lê melhor do que uma borda esquerda irregular.
• Direita — ---: — Dois-pontos à direita. É o que importa para números: valores alinhados à direita ficam certinhos na vírgula decimal, então uma coluna de preços ou contagens dá para comparar de olho.
• Nenhum — --- — Sem dois-pontos. O renderizador usa o padrão dele, que é à esquerda em todos que conhecemos, e a linha separadora fica o mais curta possível.
• Por coluna — O cabeçalho de cada coluna na pré-visualização tem seu próprio menu. Defina o padrão da tabela uma vez e depois mude as duas colunas numéricas para Direita: uma tabela de nomes e números fica correta em cerca de quatro cliques.

O texto que vem de uma planilha não faz ideia de que está prestes a virar Markdown, e vários caracteres perfeitamente comuns passam a significar algo quando isso acontece. A ferramenta separa o que ela sempre corrige do que você escolhe.

Sempre escapado

• Barras verticais — Escritas como \| . Uma barra vertical sem escape encerra a célula, o que desloca ou perde dados — não existe versão disso que alguém queira, então não é um interruptor.
• Barras invertidas — Duplicadas para \\ , e isso é feito primeiro para que as barras invertidas acrescentadas por todas as outras regras não sejam duplicadas por sua vez. Um caminho do Windows numa célula sobrevive intacto.

À sua escolha

• Caracteres Markdown — Asteriscos, sublinhados, crases, colchetes, sinais de menor/maior e tis. Uma célula com *nota* é renderizada em itálico e sem os asteriscos; escapada, lê-se *nota*. Desligado por padrão, porque a maioria das tabelas não tem nenhum deles e as barras invertidas ficam visíveis no arquivo bruto.
• Quebras de linha: <br> — O padrão. Uma quebra dentro de uma célula vira uma quebra de linha HTML, que todo renderizador de Markdown com suporte a tabelas também suporta, então um endereço de várias linhas continua sendo uma célula e continua legível.
• Quebras de linha: \n — Uma barra invertida e um n literais. Certo quando a tabela vai para um lugar que remove HTML, e quando importa que houve uma quebra sem que ela seja renderizada como tal.
• Quebras de linha: espaço — A quebra vira um único espaço. A saída mais curta, e a escolha certa quando as quebras são um artefato da exportação e não significado.
• O que não é escapado — Hifens, pontos e sinais de mais ficam como estão. Escapá-los é tecnicamente válido e transforma cada data em 2026\-01\-01 e cada preço em 12\.50, que nenhum renderizador precisa e nenhum leitor quer.

Metade do que torna uma tabela convertida errada acontece antes de qualquer Markdown ser escrito. Estes três ajustes decidem o que as linhas são, e os três são detectados do arquivo com uma substituição ao lado.

• Delimitador — Vírgula, ponto e vírgula, tabulação ou barra vertical, detectado analisando uma amostra com cada candidato e ficando com o que produz larguras de linha mais consistentes. Contar separadores na primeira linha — o atalho comum — lê "a,b,c,d";"e";"f" como separado por vírgulas e comprime cada linha em uma única coluna.
• Caractere de aspas — Aspas duplas, apóstrofo ou nenhum, detectado do mesmo jeito. Uma aspa só abre um campo na primeira posição, então um apóstrofo em O'Brien continua sendo um apóstrofo em vez de engolir o resto da linha.
• Codificação — Auto por padrão: a marca de ordem de bytes vence quando o arquivo tem uma; caso contrário, os bytes são testados como UTF-8 válido e caem para Windows-1252. Force UTF-8, UTF-16LE, UTF-16BE, Windows-1252 ou ISO-8859-1 quando um arquivo não traz marca e o palpite erra.
• ISO-8859-1 não é Windows-1252 — A plataforma web trata o primeiro como um rótulo do segundo, então a maioria das ferramentas oferece os dois e entrega um. Aqui ISO-8859-1 é de verdade Latin-1 byte a ponto de código, o que importa para arquivos em que 0x80 a 0x9F são códigos de controle e não aspas tipográficas.
• Marcas de ordem de bytes — A exportação CSV UTF-8 do Excel escreve uma, e uma ferramenta que não a remove coloca um caractere invisível na frente do título da sua primeira coluna. Aqui ela é removida, e se contradiz a codificação que você escolheu a ferramenta avisa em vez de passar por cima em silêncio.

As duas produzem a mesma tabela renderizada. A diferença é a aparência do arquivo bruto, e qual você quer depende inteiramente de quem o lê assim.

• Alinhada — Cada célula é preenchida para que as barras verticais fiquem em coluna. O Markdown bruto se lê como uma tabela em qualquer editor de texto simples, que é o que se quer quando alguém vai abrir o arquivo .md em vez de uma página renderizada.
• Compacta — Um espaço de cada lado de cada célula, nada mais. A saída é menor e — mais útil — um valor que muda em uma linha não repreenche todas as outras, então uma tabela regerada e versionada no git produz um diff de uma linha em vez de um de arquivo inteiro.
• O preenchimento segue o alinhamento — Uma coluna alinhada à direita é preenchida à esquerda; uma centralizada, dos dois lados. Assim o texto bruto fica certinho do mesmo jeito que a tabela renderizada ficará, que é o sentido de preenchê-lo.
• Linhas numeradas — Acrescenta uma coluna inicial contando as linhas do corpo a partir de um. Útil para citar uma linha em um comentário de revisão, e não faz parte dos seus dados: é regerada sempre que a tabela é.
• Primeira linha ou coluna em negrito — Envolve a primeira linha do corpo, ou a primeira coluna de cada linha do corpo, em asteriscos duplos. A linha de cabeçalho já é renderizada em negrito, então estas opções se aplicam de propósito ao corpo — pôr o cabeçalho em negrito de novo seria um controle que não faz nada.

Uma exportação de 25 MB — cerca de 225.000 linhas — é convertida em torno de um segundo em um desktop, em uma thread de segundo plano, então a página nunca trava.

Exportações reais raramente são só um cabeçalho e linhas. Quatro controles cuidam das partes que não deveriam virar células de tabela.

• Pular linhas iniciais — Remove linhas do topo antes de qualquer outra coisa. Relatórios e exportações de painéis costumam trazer um título, uma data e uma linha em branco acima do cabeçalho de verdade; pule-as e a linha um vira o cabeçalho que deveria ter sido.
• Limitar linhas — Limita quantas linhas de dados são escritas. Um README quer as primeiras vinte linhas de uma exportação grande, não as quarenta mil — e a pré-visualização mostra exatamente o que será produzido.
• Remover linhas vazias — Remove qualquer linha em que todas as células estejam em branco. Exportações de planilha acumulam essas no fim, e cada uma vira uma linha de células vazias na tabela.
• Remover colunas vazias — Remove qualquer coluna sem dados. Quando há linha de cabeçalho, o título sozinho não mantém a coluna: uma coluna sem uso mas com nome é exatamente o caso para o qual este controle existe, e o título dela vai junto.

Um arquivo é convertido no plano gratuito com todos os controles de formatação disponíveis. Converter muitos de uma vez é o que o plano Pro acrescenta, e vem em duas formas porque são dois trabalhos genuinamente diferentes.

• Um lote de arquivos — Enfileire até cinquenta CSVs, converta-os em uma ação e leve tudo como um único ZIP. Nomes de arquivo duplicados são tornados únicos dentro do arquivo compactado em vez de se sobrescreverem.
• Um documento combinado — A mesma fila escrita em um único arquivo Markdown, cada tabela sob um título tirado do nome do arquivo. É o formato que se quer para uma página de documentação que precisa mostrar quatro tabelas relacionadas no mesmo lugar.
• Os ajustes valem para a fila — Alinhamento, preenchimento, escape e o resto valem para cada arquivo do lote, então um conjunto de exportações sai consistente. O alinhamento por coluna continua por arquivo, porque as colunas diferem.
• Tudo continua no seu dispositivo — Um lote é o mesmo motor executado mais vezes. Nada é enviado, a fila é limitada pela sua própria memória e não por um servidor, e o teto de tamanho no plano Pro é o que o seu dispositivo aguenta.

A tabela que esta ferramenta escreve é Markdown no estilo GitHub, o dialeto em que quase tudo convergiu. Alguns destinos têm peculiaridades que vale conhecer antes de colar.

• GitHub e GitLab — READMEs, issues, descrições de pull requests e wikis. Os dois-pontos de alinhamento são respeitados, e <br> dentro de uma célula é renderizado como quebra de linha.
• Obsidian e VS Code — Os dois renderizam tabelas na pré-visualização e os dois leem o arquivo bruto o tempo todo, que é exatamente o caso para o qual existe a saída alinhada.
• Notion — Colar uma tabela Markdown cria uma tabela de verdade do Notion. O alinhamento não é levado junto, então os dois-pontos não atrapalham mas também não fazem nada.
• Jira e Confluence — O Jira moderno converte uma tabela Markdown colada. O Confluence antigo usa marcação própria de tabelas, então cole em uma macro Markdown e não no corpo da página.
• Geradores de sites estáticos — Jekyll, Hugo, Docusaurus, MkDocs e Astro renderizam tabelas GFM em arquivos de conteúdo. A saída compacta mantém os diffs de origem pequenos quando uma tabela é regerada a partir de dados.

Tabelas Markdown são usadas em READMEs, documentação e sites estáticos. Converter CSV para Markdown permite embutir dados tabulares em conteúdo baseado em Markdown, e os mantém no mesmo controle de versão do código que documentam.

• Docs e READMEs — Coloque tabelas na documentação sem digitar uma única barra vertical, e sem uma captura de tela que fica desatualizada assim que os números mudam.
• Texto portável — Markdown mantém os dados legíveis em repositórios, wikis e geradores estáticos — e legíveis como texto simples quando nada os renderiza.
• Revisável em um diff — Uma tabela guardada como texto mostra o que mudou linha a linha em um pull request. Uma planilha anexada ao mesmo commit não mostra nada.
• Sem dependência para instalar — O resultado é texto. Não precisa de plugin, extensão nem ambiente de execução onde quer que vá parar, o que não vale para uma planilha embutida nem para a imagem de um gráfico.

• Delimitador — Detecção automática por consistência, ou escolha vírgula, ponto e vírgula, tabulação ou barra vertical.
• Caractere de aspas — Detecção automática, aspas duplas, apóstrofo ou nenhum.
• Codificação — Auto com detecção de marca de ordem de bytes, UTF-8, UTF-16LE, UTF-16BE, Windows-1252 ou um ISO-8859-1 de verdade.
• Primeira linha como cabeçalho — Ligado, a linha um é o cabeçalho; desligado, todas as linhas são dados e rótulos Col 1, Col 2 são gerados.
• Alinhamento — Esquerda, centro, direita ou nenhum para a tabela, substituível por coluna pelo cabeçalho da pré-visualização.
• Saída alinhada — Deixe as colunas certinhas no arquivo bruto, ou mantenha-o compacto para diffs menores.
• Escapar caracteres Markdown — Escapa asteriscos, sublinhados, crases, colchetes, sinais de menor/maior e tis além das barras verticais e barras invertidas sempre escapadas.
• Quebras de linha numa célula — Transforme uma quebra em <br>, em um \n literal ou em um espaço.
• Linhas numeradas, linha e coluna em negrito — Uma coluna de contagem, uma primeira linha de dados em negrito e uma primeira coluna em negrito — de forma independente.
• Pular, limitar e limpar — Remova linhas iniciais, limite a quantidade de linhas e tire linhas e colunas que não têm nada.
• Baixar como — Nome de arquivo personalizado para o .md; a extensão é acrescentada se você omitir.

• CSV para JSON
• CSV para XML
• CSV para Excel
• Ferramentas CSV
• An OpenDocument spreadsheet

  Same typed columns and frozen header, for readers who use LibreOffice rather than Excel

• Cut it down first

  A README wants the rows that matter, not all forty thousand of them