Gerador de tabelas Markdown

Como criar uma tabela Markdown

1. Escreve o conteúdo na grelha. A primeira linha é o cabeçalho da tabela.
2. Usa Adicionar linha, Adicionar coluna, Remover última linha e Remover última coluna, ou os pequenos botões ×, para dar forma à tabela. Nova tabela vazia recomeça com uma grelha de 3 × 3.
3. Escolhe o alinhamento de cada coluna no menu por cima dela: Predefinido, Esquerda, Centro ou Direita.
4. Mantém Alinhar as colunas no código Markdown marcado para teres uma tabela fácil de ler em texto simples, ou desmarca-o para obteres o código mais curto possível.
5. Copia o resultado ou transfere-o como ficheiro .md. A Pré-visualização mostra o aspeto da tabela depois de renderizada.

Para partires de dados que já tens, cola-os em Importar dados, escolhe um Formato (ou deixa Deteção automática) e clica em Importar. Também podes colar um bloco de células copiado do Excel, do LibreOffice ou do Google Sheets diretamente em qualquer célula da grelha: a grelha cresce para receber o bloco a partir dessa célula.

Como funcionam as tabelas Markdown

As tabelas não fazem parte da sintaxe Markdown original. Vêm da especificação GitHub Flavored Markdown (GFM), suportada pelo GitHub, GitLab, Bitbucket, pela maioria dos geradores de sites estáticos, pelo Obsidian, pelas exportações do Notion e por muitas ferramentas de documentação. Uma tabela GFM tem três partes:

• uma linha de cabeçalho, com as células separadas por barras verticais: | Name | Score |;
• uma linha delimitadora feita de hífenes, uma célula por coluna: | --- | --- |;
• qualquer número de linhas de corpo.

A linha delimitadora também define o alinhamento. Dois pontos à esquerda (:---) alinham a coluna à esquerda, dois pontos à direita (---:) alinham-na à direita e dois pontos dos dois lados (:---:) centram-na. Sem dois pontos, o renderizador usa a sua predefinição, normalmente à esquerda.

Em GFM o cabeçalho é obrigatório: uma tabela sem cabeçalho não é reconhecida. Se os teus dados não têm um cabeçalho natural, dá à primeira linha nomes curtos de colunas.

Caracteres especiais e quebras de linha

Uma barra vertical dentro de uma célula terminaria a célula, por isso esta ferramenta escapa-a como \|. Uma barra já escapada fica como está, para que o resultado nunca seja escapado duas vezes. As tabelas Markdown também não podem conter quebras de linha reais: uma quebra de linha nos dados importados passa a <br>, que o GitHub e a maioria dos renderizadores mostram como uma nova linha dentro da célula. Tudo o resto, incluindo **negrito**, `código` e ligações, é mantido tal como o escreveste, por isso podes usar Markdown em linha nas células.

Quando as colunas estão alinhadas, os caracteres largos, como texto chinês, japonês ou coreano e os emojis, contam como duas colunas, para que as barras fiquem alinhadas num editor de letra monoespaçada.

Importar CSV, células de folhas de cálculo ou uma tabela Markdown

A Deteção automática procura primeiro uma tabela Markdown em qualquer parte do texto colado, com o respetivo alinhamento. Caso não a encontre, o texto é lido como dados delimitados: separados por tabulações quando a primeira linha tem uma tabulação (o que as folhas de cálculo põem na área de transferência), senão por vírgula, ponto e vírgula ou barra vertical, conforme o que aparecer mais vezes. Os valores entre aspas, como "Silva, Jr.", são tratados como em CSV. A grelha aceita até 500 linhas e 30 colunas.