Conversor de CSV para Markdown

READMEs, descrições de pull requests e sites de documentação renderizam tabelas Markdown de forma bonita, desde que você se dê ao trabalho de escrever manualmente os pipes e traços. Este conversor lê um CSV, usa a primeira linha como cabeçalho e emite uma tabela Markdown com formatação do GitHub com a linha de separador correta. Cada célula fica cercada por delimitadores |, pronta para colar em um README ou na descrição de um pull request.

Como a tabela é construída

  1. 1

    Cole o CSV

    Por padrão, é um exemplo de três colunas; troque pelos seus próprios dados.

  2. 2

    Escolha o delimitador

    Vírgula por padrão. Escolha tabulação, ponto e vírgula ou barra vertical na lista para combinar com seus dados.

  3. 3

    A linha 1 é o cabeçalho

    A primeira linha é emitida como o cabeçalho Markdown, seguida pela linha de separador necessária `| --- | --- |`.

  4. 4

    Linhas preenchidas até a largura

    Se uma linha de dados tiver menos células do que o cabeçalho, o conversor preenche com strings vazias para manter a tabela retangular.

Renderização, alinhamento e onde funcionará e onde não funcionará

Tabelas Markdown com formatação do GitHub (GFM) são amplamente suportadas, mas não universais. Saber onde elas renderizam é a diferença entre um README nítido e uma parede de pipes.

Suportado em

  • Pull requests e wikis do GitHub, GitLab e Bitbucket
  • A maioria dos geradores de sites estáticos (Docusaurus, VitePress, MkDocs Material)
  • Pré-visualização de Markdown no VS Code
  • Notion (via colar como markdown)

Não suportado em

  • CommonMark sem a extensão GFM
  • Reddit (usa seu próprio subconjunto)
  • Alguns motores de wiki legados (DokuWiki, MoinMoin)

Alinhamento de colunas

Tabelas GFM suportam alinhamento à esquerda, centro e direita através de dois pontos na linha de separador. Este conversor emite separadores simples ---; se você precisar de alinhamento, processe após:

Sintaxe Efeito
:--- Alinhar à esquerda
:---: Alinhar ao centro
---: Alinhar à direita

Substitua a linha de separador por | :--- | :---: | ---: | correspondendo às colunas que você deseja inclinar.

Caracteres de citação em células Markdown

  • Caracteres pipe (|) dentro de uma célula devem ser escapados como \\| para evitar a divisão da célula. O conversor não os escapa automaticamente, então limpe previamente se seus dados contiverem pipes.
  • Quebras de linha dentro de uma célula quebram a renderização GFM. Substitua-as por <br> antes da conversão se você quiser quebras de linha suaves dentro de uma célula.
  • Asteriscos, sublinhados e crases passam; eles são interpretados como ênfase ou código Markdown. Escape com uma barra invertida à frente se você quiser que sejam literais.

Perguntas frequentes

Não por padrão: a linha de separador é simplesmente ---. Substitua por :---, :---: ou ---: após a conversão para fixar a coluna à esquerda, ao centro ou à direita.

Escape-os com uma barra invertida antes da conversão, transformando | em \|. Caso contrário, o renderizador Markdown os trata como separadores de coluna e quebra a tabela.

Tabelas GFM renderizam no GitHub, GitLab, na maioria dos geradores de sites estáticos e no VS Code. Elas não renderizam em CommonMark puro, Reddit ou algumas wikis legadas sem um plugin.

Sim. O CSV é enviado ao nosso servidor para que o conversor possa montar a tabela. Ele não é armazenado e não é adicionado ao link da página.

Ferramentas relacionadas