O que esta ferramenta faz
Esta ferramenta transforma dados CSV em uma tabela Markdown que voce pode colar direto no GitHub, na documentacao de um projeto ou em um README. Ela usa um editor de dois paineis: voce digita ou cola suas linhas separadas por virgula a esquerda e uma tabela formatada corretamente aparece a direita no momento em que voce digita, sem nenhum botao Converter para apertar. Se uma linha nao bater com o cabecalho, uma mensagem embutida sinaliza isso para voce corrigir, e quando o resultado esta bom voce pode copia-lo ou baixa-lo como um arquivo .md. Ela ajuda desenvolvedores que documentam uma API, redatores que montam uma tabela comparativa e qualquer pessoa que mantem anotacoes em Markdown e quer tabelas organizadas sem a sintaxe trabalhosa.
A primeira linha do seu CSV e lida como o cabecalho. Esses valores viram os titulos das colunas, uma linha separadora e inserida abaixo deles, e cada linha restante vira uma linha da tabela.
Como usar
- Cole ou digite seu CSV no painel esquerdo, ou clique em Carregar exemplo para inserir uma amostra. Coloque os nomes das colunas na primeira linha, por exemplo
name,age, e depois suas linhas de dados abaixo, um registro por linha, comoAda,36. - A tabela Markdown aparece no painel direito instantaneamente enquanto voce digita, entao nao ha nada para clicar para converter.
- Se aparecer um erro embutido, como uma linha com o numero errado de colunas, corrija a linha sinalizada e a tabela atualiza na hora.
- Use Copiar para pegar o Markdown, ou Baixar para salva-lo como um arquivo
.md, e depois cole no seu README, issue, documento ou comentario. Limpar esvazia os dois paineis quando voce quiser recomecar.
Um exemplo rapido
Dado name,age na primeira linha e Ada,36 na segunda, voce obtem uma tabela com barras: uma linha de cabecalho com name e age, uma linha separadora de tracos e uma linha de dados com Ada e 36. Um problema comum e uma virgula perdida dentro de um valor, ja que isso divide a celula em duas colunas, entao envolva esses valores com cuidado ou limpe-os primeiro.
Esta ferramenta funciona inteiramente no seu navegador. E privada, gratuita e nao exige cadastro.
Perguntas frequentes
- Como o conversor usa o meu CSV?
- A primeira linha e tratada como o cabecalho. Cada valor dessa linha vira um titulo de coluna, e cada linha abaixo dela vira uma linha da tabela. Uma linha separadora de cabecalho e adicionada automaticamente para que o resultado seja Markdown valido.
- Onde posso colar a tabela Markdown?
- Em qualquer lugar que renderize Markdown, incluindo issues e pull requests do GitHub, arquivos README, GitLab, Reddit e a maioria das ferramentas de sites estaticos e de documentacao. Basta colar a saida e ela aparece como uma tabela formatada.
- Preciso clicar em algo para converter?
- Nao. A tabela e atualizada ao vivo no painel direito no momento em que voce digita ou cola o CSV no painel esquerdo, entao nao ha nenhum botao Converter para apertar.
- E se o meu CSV estiver malformado?
- A ferramenta mostra uma mensagem clara embutida quando algo nao encaixa, por exemplo uma linha com um numero de colunas diferente do cabecalho. Corrija a linha sinalizada e a tabela atualiza instantaneamente.
- Posso carregar dados de exemplo para ver como funciona?
- Sim. O botao Carregar exemplo preenche a entrada com um CSV pequeno ja pronto, para que voce veja a tabela Markdown surgir na hora e parta de um exemplo que funciona.
- Posso copiar ou baixar o resultado?
- Sim. Use o botao Copiar para colocar a tabela Markdown na area de transferencia, ou o botao Baixar para salva-la como um arquivo .md. Um botao Limpar esvazia os dois paineis para comecar de novo.
- Meu CSV e enviado para algum lugar?
- Nao. Toda a conversao acontece no seu navegador com JavaScript, entao seus dados nunca saem do seu dispositivo. Isso o torna seguro para exportacoes privadas e listas internas.