O que faz
Digitar tabelas Markdown é cansativo: cada linha precisa de barras verticais, a segunda linha precisa de hifens e manter as colunas alinhadas à mão leva uma eternidade. Esta ferramenta converte dados CSV ou TSV em uma tabela GitHub Flavored Markdown que você pode colar em um README, pull request, issue, wiki ou qualquer documentação em Markdown.
O CSV é analisado corretamente, então campos entre aspas com vírgulas, aspas duplicadas e células com várias linhas são tratados. A saída é preenchida com espaços para que as colunas fiquem alinhadas em texto puro, o que facilita ler e editar a tabela depois.
Como usar
- Cole CSV ou TSV, envie um arquivo
.csvou.tsv, ou clique em Exemplo. - Escolha o Alinhamento: padrão, esquerda, centro, direita ou Números à direita para alinhar à direita colunas que só têm números.
- Mantenha Primeira linha é o cabeçalho ativado se a primeira linha tiver os nomes das colunas; caso contrário, o cabeçalho será Column 1, Column 2 etc.
- Desative Alinhar colunas se preferir linhas compactas sem preenchimento.
- Copie a tabela ou baixe como arquivo
.md.
Linhas com menos células que o cabeçalho são completadas com células vazias, então a tabela é sempre válida.
Exemplo
Este CSV:
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendliervira esta tabela Markdown com o alinhamento Números à direita:
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |A vírgula dentro do campo entre aspas fica na célula, a barra vertical é escapada e a coluna numérica recebe o marcador --: para ficar alinhada à direita quando renderizada.
Dicas
- Os marcadores de alinhamento da segunda linha (
:--,:-:,--:) controlam o alinhamento de cada coluna na tabela renderizada. - Markdown em linha dentro das células, como
**negrito**, código em linha ou links, é mantido e renderizado pela maioria dos visualizadores. - Tabelas muito largas são difíceis de ler em telas pequenas; considere dividir as colunas em várias tabelas.
- Para gerar uma tabela HTML, ou transformar um array JSON em tabela Markdown, use as ferramentas relacionadas abaixo.
Perguntas frequentes
› Qual variante de Markdown a tabela usa?
As tabelas com barras verticais do GitHub Flavored Markdown (GFM), também suportadas pelo GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs e pela maioria dos geradores de sites estáticos. O CommonMark puro não tem sintaxe de tabela.
› O que acontece com barras verticais e quebras de linha dentro das células?
Uma barra vertical encerraria a célula, então ela é escrita como \|. Quebras de linha não são permitidas dentro de uma linha da tabela, então viram tags <br>, que o GitHub e a maioria dos renderizadores exibem como quebra de linha.
› Por que colunas em chinês, japonês ou coreano ficam alinhadas?
Com Alinhar colunas ativado, as células são preenchidas pela largura de exibição: caracteres largos do Leste Asiático contam como duas colunas, então o Markdown fica alinhado num editor com fonte monoespaçada. A tabela renderizada fica igual de qualquer forma.
› Posso converter TSV copiado do Excel ou do Google Planilhas?
Sim. Células copiadas de uma planilha são separadas por tabulações, e o delimitador é detectado automaticamente. Você também pode escolher Tab explicitamente.