Por que usar um gerador de tabela Markdown
As tabelas em Markdown são texto simples. Cada linha é uma linha do texto, as células são separadas por barras verticais e uma linha divisória de traços fica embaixo do cabeçalho. Isso é fácil de ler, mas lento de digitar, e manter as colunas alinhadas à mão é cansativo. Um valor mais longo obriga você a reajustar todas as outras linhas.
Esta ferramenta oferece uma grade para digitar, como uma pequena planilha, e escreve o Markdown para você. Ela também lê dados que você já tem: células copiadas do Excel ou do Planilhas Google, texto CSV ou uma tabela Markdown existente.
Como usar a grade
- Digite em qualquer célula. A primeira linha é o cabeçalho e aparece em negrito.
- Adicionar linha e Adicionar coluna aumentam a tabela. Os pequenos botões x ao lado de cada linha e acima de cada coluna removem a linha ou a coluna.
- Pressione Enter para descer uma linha. Na última linha, o Enter acrescenta uma nova.
- Alinhamento: o seletor acima de cada coluna define Padrão, Esquerda, Centro ou Direita.
- Cole um bloco de células em qualquer célula para preencher a grade a partir daquele ponto.
- Colar dados abre uma caixa para células de planilha, CSV ou uma tabela Markdown. Clique em Carregar na grade para trocar a grade por esses dados.
- Trocar linhas e colunas vira a tabela de lado.
- Exemplo carrega uma tabela de exemplo e Limpar recomeça com uma grade vazia de 3 por 3.
O Markdown aparece embaixo da grade. Alinhar colunas preenche cada célula com espaços para a tabela ficar legível como texto simples. Desligue para ter o resultado mais curto. Copiar leva a tabela para a área de transferência e Baixar salva um arquivo .md.
Exemplo
Uma pequena tabela de preços com a primeira coluna alinhada à esquerda, os preços à direita e a quantidade de usuários centralizada:
| Plan | Price | Users |
| :------- | ----: | :-------: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |Os dois-pontos na linha divisória definem o alinhamento: dois-pontos à esquerda significa esquerda, à direita significa direita, dos dois lados significa centro. Com Alinhar colunas desligado, a mesma tabela é escrita sem preenchimento:
| Plan | Price | Users |
| :-- | --: | :-: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |As duas versões aparecem iguais depois de renderizadas. A preenchida é mais fácil de ler e editar em um arquivo de texto. A compacta é mais curta e gera diffs menores quando um único valor muda.
Caracteres especiais nas células
Uma barra vertical dentro de uma célula encerraria a célula antes da hora, então o gerador faz o escape dela. Uma quebra de linha dentro de uma célula, que pode vir de uma colagem de planilha, vira <br>:
| Command | Meaning |
| -------------- | ----------- |
| a \| b | pipe output |
| line1<br>line2 | two lines |Outros elementos de Markdown dentro de uma célula, como **negrito**, um link ou código em linha, são mantidos e aparecem normalmente.
O preenchimento conta os caracteres chineses, japoneses e coreanos como duas colunas de largura, porque é assim que eles aparecem na maioria das fontes monoespaçadas. Isso mantém as barras verticais alinhadas nos editores que usam essas fontes. Letras acentuadas do português, como em “Preço” ou “Ação”, contam como um caractere cada, então o alinhamento também fica certo.
Onde as tabelas Markdown funcionam
GitHub, GitLab, Bitbucket, Obsidian, Reddit e a maioria dos geradores de sites estáticos aceitam essa sintaxe de tabela. Ela vem do GitHub Flavored Markdown. O Markdown original não tinha tabelas, então um renderizador muito antigo pode mostrar as barras verticais sem formatação.
Dicas
- Mantenha as tabelas estreitas. Frases longas ficam melhor em parágrafos. Uma tabela com 3 a 6 colunas curtas é a mais fácil de ler no celular.
- Comece por uma planilha quando os dados já estiverem em uma. Copie o intervalo, cole na primeira célula e ajuste o alinhamento.
- Para organizar uma tabela dentro de um documento mais longo, cole o documento inteiro no formatador Markdown. Ele alinha as tabelas do mesmo jeito.
- Para dados que devem virar JSON em vez de uma tabela, use a ferramenta de converter CSV para JSON.
- Para transformar uma tabela HTML de uma página web em Markdown, use a ferramenta de converter HTML para Markdown.
Outras formas de criar tabelas Markdown
- VS Code: extensões como a Markdown All in One formatam as tabelas no próprio lugar quando você formata o documento.
- O Pandoc transforma um CSV ou uma exportação de planilha em uma tabela Markdown na linha de comando.
- Planilhas Google: não há exportação para Markdown embutida, mas copiar as células e colar aqui leva poucos segundos.
Tudo acontece no seu navegador. Os dados que você cola não são enviados para lugar nenhum.