Gerador de tabelas Markdown
Edite uma tabela numa grade, ou cole de uma planilha, CSV ou TSV, e copie como tabela Markdown do GitHub com colunas bem alinhadas.
Funciona no seu navegador; nada do que você digita sai do seu dispositivo
Tabelas de até alguns milhares de células. As tabelas Markdown comportam uma única linha de texto por célula, então quebras de linha dentro de uma célula são escritas como <br> e as barras verticais são escapadas. A primeira linha é sempre o cabeçalho, como o GitHub exige.
Como criar uma tabela Markdown
- Digite na grade ou cole direto as células copiadas de uma planilha. Você também pode colar CSV, TSV ou uma tabela Markdown existente na caixa e preencher a grade com esse texto.
- Adicione ou remova linhas e colunas e escolha alinhamento à esquerda, centralizado ou à direita para cada coluna.
- Copie o Markdown e cole no seu README, issue, pull request ou documento.
Como uma tabela Markdown é escrita
Uma tabela Markdown do GitHub é texto simples: uma linha de cabeçalho, uma linha de hífens que define o alinhamento e uma linha para cada linha de dados, com as células separadas por barras verticais. É o formato que o GitHub exibe em READMEs, issues e pull requests, e muitas outras ferramentas, como sites de documentação e apps de notas, também o entendem.
A grade guarda as células; a primeira linha é o cabeçalho. Cada coluna tem um alinhamento. Esquerda se escreve :---, centro :---:, direita ---: e sem alinhamento são só hífens. O texto das células é escapado quando necessário: a barra vertical vira \| e a quebra de linha vira a tag HTML <br>. Depois a ferramenta alinha as colunas com espaços para que o código pareça uma tabela, usando a largura de cada caractere e não o tamanho em bytes, de modo que letras acentuadas também fiquem alinhadas.
Colar de uma planilha é a forma mais rápida de começar. As planilhas colocam as células copiadas na área de transferência como texto separado por tabulações, com uma linha por linha da tabela, e a grade lê isso diretamente. Arquivos CSV e TSV funcionam do mesmo jeito pela caixa de colagem, com campos entre aspas e quebras de linha entre aspas tratados. Se você colar uma tabela Markdown existente, as células e os alinhamentos são lidos de volta para a grade, e você pode alterá-los.
Dicas
- Tem JSON em vez de uma planilha? Converta primeiro com JSON para CSV e cole o resultado aqui.
- Veja como a tabela vai ficar com Markdown para HTML.
- Para fazer o caminho inverso, de uma página da web de volta para Markdown, use HTML para Markdown.
Perguntas frequentes
Como transformo uma planilha em uma tabela Markdown?
Selecione as células no Excel, Google Planilhas ou Numbers, copie e cole em qualquer célula da grade. As células da planilha chegam como texto separado por tabulações, e a grade é preenchida a partir da célula em que você colou. Você também pode colar CSV ou TSV na caixa acima da grade e escolher Preencher a grade com este texto.
Como funciona o alinhamento das colunas?
A linha de hífens abaixo do cabeçalho define o alinhamento: :--- é esquerda, :---: é centralizado, ---: é direita e --- é o padrão. Escolha o alinhamento de cada coluna acima da célula do cabeçalho.
O que acontece com uma barra vertical ou uma quebra de linha em uma célula?
Uma barra vertical | encerraria a célula, então ela é escrita como \|. Tabelas Markdown não aceitam quebras de linha reais, então uma quebra dentro de uma célula é escrita como <br>, que o GitHub exibe como uma nova linha.
Por que as colunas são preenchidas com espaços?
O preenchimento alinha as colunas para que a tabela seja fácil de ler como texto simples. Ele não muda como o resultado é exibido. Desmarque Alinhar as colunas para obter a forma mais curta.
Posso editar uma tabela Markdown que já tenho?
Sim. Cole na caixa e escolha Preencher a grade com este texto. A ferramenta lê as células e os alinhamentos e os coloca na grade.
Minha tabela é enviada para algum servidor?
Não. A tabela é criada no seu navegador e nada sai do seu dispositivo.