Converter CSV em tabela Markdown

Como converter CSV em Markdown

1. Clique em Abrir arquivo, arraste um arquivo .csv, .tsv ou .txt para a ferramenta ou escolha Colar. O delimitador é detectado sozinho; se o palpite estiver errado, ajuste-o, a codificação ou a opção A primeira linha tem os nomes das colunas em Configurações de importação.
2. Escolha o Alinhamento das colunas e como ficam as Quebras de linha dentro das células. A aba Markdown mostra exatamente o texto que vai no download.
3. Use Copiar para colar a tabela direto no GitHub, no GitLab ou no seu editor, ou Baixar Markdown para salvar um arquivo .md.

Se o arquivo não tiver linha de cabeçalho, desative A primeira linha tem os nomes das colunas. Como toda tabela Markdown precisa de cabeçalho, as colunas recebem os nomes Column 1, Column 2 e assim por diante. Para mostrar os mesmos dados como tabela de página web, use CSV para HTML.

O que cada opção faz

Como os dados mais delicados são tratados

• Pipes e barras invertidas são sempre escapados (\|, \\), mesmo com Escapar caracteres do Markdown desativado, porque um | sem escape abriria uma nova célula.
• Vírgulas e quebras de linha entre aspas são lidas conforme a RFC 4180, então "Cable tidy, 3-pack" continua em uma só célula. Um aviso acima da prévia informa quantos valores tinham quebra de linha.
• Os valores são gravados como texto: 00731 mantém os zeros e 34.90 mantém o zero final. Nada é arredondado nem reformatado.
• Um cabeçalho em branco vira Column 3 e um repetido vira name (2), para que cada coluna tenha um título próprio.
• Os renderizadores de Markdown cortam espaços no início e no fim da célula, e uma tabela não pode conter listas nem parágrafos; deixe esse tipo de conteúdo em um documento à parte.

Solução de problemas

• O texto depois da tabela gruda na última linha. A tabela só termina em uma linha em branco ou no início de outro bloco; deixe uma linha vazia depois dela.
• Todos os valores ficaram em uma coluna só. O delimitador foi detectado errado. Escolha Vírgula, Ponto e vírgula, Tabulação ou Barra vertical em Configurações de importação e abra o arquivo de novo.
• **Aparecem barras invertidas antes de * ou _ no resultado.** É o escape funcionando em um renderizador que não o interpreta. Desative Escapar caracteres do Markdown se os seus dados não tiverem caracteres de formatação a proteger.
• As quebras de linha aparecem como uma tag literal. O renderizador não aceita HTML. Escolha Trocar por um espaço em Quebras de linha dentro das células.

Limites e privacidade

Arquivos de até 25 MB, 100.000 linhas ou 2 milhões de células abrem com prévia ao vivo das primeiras 200 linhas. Arquivos maiores são convertidos em modo de streaming: o arquivo é lido duas vezes, em partes (uma para medir as colunas e suas larguras, outra para gravar), um aviso informa que o download cobre o arquivo inteiro e a opção Copiar não fica disponível. Cada arquivo de saída tem limite de 4 GB.

A conversão roda em um worker em segundo plano nesta aba, então a página continua respondendo e Cancelar interrompe o processo. O CSV nunca é enviado a um servidor. Para conferir um arquivo grande antes de converter, abra-o no visualizador de CSV.

Exemplo

Uma lista de produtos com SKU começando em zero, um pipe dentro de um nome, uma vírgula entre aspas e uma observação em duas linhas, convertida com as configurações padrão. price fica alinhada à direita porque todos os valores são números; sku não, porque 00731 é mantido como texto.

sku,name,price,note
00731,"Desk lamp | brass",34.90,"Ships in 2 days
from Leeds"
00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025
00733,USB-C hub,129.00,

| sku   | name                     |  price | note                             |
| ----- | ------------------------ | -----: | -------------------------------- |
| 00731 | Desk lamp \| brass       |  34.90 | Ships in 2 days<br>from Leeds    |
| 00732 | Cable tidy, 3-pack white |   4.50 | Back-ordered until 14 March 2025 |
| 00733 | USB-C hub                | 129.00 |                                  |