Conversor de CSV para tabela Markdown
Converta arquivos CSV para a sintaxe de tabela Markdown (`| col1 | col2 |`). Você pode escolher o delimitador, se a primeira linha deve ser usada como cabeçalho, e o alinhamento das colunas (esquerda, centro, direita). O resultado pode ser copiado ou baixado. A conversão ocorre inteiramente no seu navegador; nenhum dado é enviado a um servidor.
| Delimitador |
|
|---|---|
| Usar a primeira linha como cabeçalho | |
| Alinhamento das colunas |
|
Insira dados CSV para ver aqui a tabela Markdown gerada.
Como uma linha de CSV se transforma em uma tabela Markdown
| Uma linha de CSV | name,age,city |
|---|---|
| Sintaxe Markdown resultante | | name | age | city | |
Quando a primeira linha é usada como cabeçalho, ela se torna a linha de cabeçalho, seguida de uma linha delimitadora (---) que indica o alinhamento, e cada linha seguinte se torna uma linha de dados.
O que é um conversor de CSV para tabela Markdown
Uma tabela Markdown é desenhada inteiramente com barras verticais e hifens, o que a torna perfeitamente legível como texto simples, mas trabalhosa de digitar à mão assim que há mais do que algumas colunas. Se os dados de origem já existem em CSV — exportados de uma planilha, resultado de uma consulta a banco de dados ou um arquivo de log — não há motivo para redigitá-los célula por célula. Esta ferramenta lê o CSV e o reconstrói como uma tabela Markdown completa: uma linha de cabeçalho, uma linha delimitadora que marca o alinhamento das colunas e uma linha de dados para cada linha de entrada.
Como uma linha de tabela Markdown precisa caber em uma única linha física, algumas conversões acontecem automaticamente durante o processo. Barras verticais encontradas dentro de uma célula são protegidas para não serem confundidas com um limite de coluna, e quebras de linha dentro de células multilinha entre aspas são condensadas em um único espaço. Você também pode escolher alinhamento à esquerda, ao centro ou à direita para as colunas, o que insere o padrão correspondente de dois-pontos e hifens na linha delimitadora. Tudo acontece localmente no seu navegador, então o CSV que você cola nunca sai da sua máquina.
Como gerar uma tabela Markdown a partir de um CSV
- Cole os dados CSV Cole o texto CSV na caixa de entrada. Se você copiou direto de uma planilha, troque o delimitador para tabulação em vez de vírgula.
- Decida se a primeira linha é um cabeçalho Se a primeira linha contém os nomes das colunas, ative "Usar a primeira linha como cabeçalho" e a linha delimitadora será inserida automaticamente logo abaixo.
- Escolha um alinhamento de colunas Colunas numéricas costumam ficar mais legíveis alinhadas à direita. Deixando o alinhamento sem especificar, o renderizador Markdown aplica seu próprio padrão.
- Copie o resultado para o seu documento Copie o Markdown gerado e cole em um README, um issue, a descrição de um pull request ou um artigo técnico.
Dicas para aproveitar melhor
- Qualquer caractere de barra vertical (|) dentro de uma célula é automaticamente escapado como \| para não ser confundido com um separador de colunas.
- Quebras de linha dentro de células multilinha entre aspas são substituídas por um espaço, já que uma linha de tabela Markdown precisa caber em uma única linha física.
- Ao escolher alinhamento "Esquerda", "Centro" ou "Direita", `:---`, `:---:` ou `---:` são inseridos na linha delimitadora, para que renderizadores como o GitHub exibam as colunas com o alinhamento desejado.
- Combine com as ferramentas irmãs CSV para JSON e CSV para SQL para converter o mesmo CSV no formato de saída que você precisar.
Onde um conversor de CSV para Markdown é útil
Tabelas em um README
Organize primeiro em uma planilha uma matriz de compatibilidade ou uma lista de opções de configuração, depois converta: você obtém uma tabela Markdown limpa sem lutar manualmente com a largura das colunas.
Comparações em issues e pull requests
Transforme resultados de testes ou uma lista de candidatos em uma tabela na hora. Como continua sendo texto simples, também é fácil de ler dentro de um diff.
Preparar dados para um artigo técnico
Dados de medições podem virar diretamente uma tabela no artigo. Alinhar as colunas numéricas à direita mantém os dígitos alinhados e fáceis de comparar.
Organizar atas e documentação
Útil ao migrar uma lista que antes era mantida em uma planilha para uma documentação mantida em Markdown.
Termos das tabelas Markdown
- Sintaxe de tabela
- A notação do Markdown para dispor uma tabela como células separadas por barras verticais. Não fazia parte da especificação original e foi adicionada depois como extensão.
- Linha delimitadora
- A linha de hifens colocada logo abaixo da linha de cabeçalho. Indica ao interpretador onde o cabeçalho termina e os dados começam.
- Marcador de alinhamento
- Os dois-pontos adicionados junto aos hifens da linha delimitadora para indicar alinhamento à esquerda, ao centro ou à direita naquela coluna.
- GFM
- Abreviação de GitHub Flavored Markdown, uma especificação estendida definida pelo GitHub que se tornou o padrão de fato para a sintaxe de tabelas.
- Escape
- O processo de colocar uma barra invertida antes de uma barra vertical dentro de uma célula para que não seja confundida com um separador de colunas.
Perguntas frequentes
Curiosidade — Por que tabelas Markdown não precisam de nada além de barras verticais e hifens
O Markdown foi criado em 2004 por John Gruber e Aaron Swartz como uma linguagem de marcação leve construída em torno da ideia de que o texto simples deve continuar fazendo sentido mesmo quando lido como está. A sintaxe de tabela não é exceção: como as linhas são desenhadas apenas com barras verticais e hifens, não é preciso abrir e fechar tags como a <table> do HTML, e o formato da tabela é reconhecível apenas olhando o código-fonte não renderizado.
A sintaxe de tabela nunca fez parte da especificação original do Markdown de John Gruber; foi adicionada depois como uma extensão pelo PHP Markdown Extra e, de forma mais influente, pelo GitHub Flavored Markdown (GFM). Por isso, diferenças sutis de comportamento persistem entre implementações (como o tratamento de um número de colunas inconsistente), e a maioria das grandes plataformas — GitHub, GitLab e similares — segue de modo geral o GFM.
A necessidade de colar diretamente na documentação o resultado de uma planilha ou banco de dados surge constantemente ao escrever READMEs, issues e artigos técnicos. Digitar manualmente barras verticais e linhas delimitadoras é cansativo, então um conversor de CSV de um clique se tornou uma etapa de preparação padrão para quem documenta em Markdown.