Gerador de tabelas Markdown

Modo de entrada

A primeira linha é o cabeçalho da tabela.

Alinhamento de colunas

Pré-visualização em tempo real

Como usar o gerador de tabelas Markdown

1. 1. Escolha um modo de entrada. Editor de grade visual oferece uma grade 3 × 3 para digitar, com botões para adicionar ou remover linhas e colunas (no mínimo 2 linhas e 1 coluna). Colar CSV / TSV aceita dados copiados de uma planilha ou de um arquivo de texto.
2. 2. Preencha a tabela. A primeira linha é sempre o cabeçalho. No modo de colagem, cada linha do texto vira uma linha da tabela.
3. 3. Defina o alinhamento. Uma lista suspensa para cada coluna oferece Esquerda, Centro ou Direita.
4. 4. Copie o Markdown. A tabela com espaçamento aparece em Markdown, com uma pré-visualização ao vivo abaixo. Copiar Markdown copia o código-fonte.

Como uma tabela Markdown é formada

Tabelas não fazem parte do Markdown básico nem da especificação CommonMark; elas vêm da especificação GitHub Flavored Markdown, seguida pelo GitHub, pelo GitLab e por muitas ferramentas de documentação. Uma tabela é formada por uma linha de cabeçalho, uma linha delimitadora e quantas linhas de corpo forem necessárias, com células separadas por barras verticais. A linha delimitadora é o que faz dela uma tabela: cada célula é feita de hifens, e os dois-pontos definem o alinhamento.

A linha de cabeçalho precisa ter o mesmo número de células que a linha delimitadora, ou a tabela não é reconhecida. Uma barra vertical literal dentro de uma célula precisa ser escrita como \|, o que o gerador faz por você. As células são texto de uma linha só, mas a formatação inline, como negrito ou links, funciona dentro delas, e a tabela termina na primeira linha em branco.

Exemplo prático

Cole Name,Role,Score, depois Alice,Editor,92, Bob,Writer,7 e C|D,Reviewer,100 como quatro linhas, e defina as colunas como Esquerda, Centro e Direita. O resultado é:

| Name  |   Role   | Score |
| :---- | :------: | ----: |
| Alice |  Editor  |    92 |
| Bob   |  Writer  |     7 |
| C\|D  | Reviewer |   100 |

Cada coluna é preenchida até a célula mais larga, para que as barras verticais fiquem alinhadas, com largura mínima de três. O código-fonte é mais longo do que uma tabela precisa, mas é legível em um diff de texto simples e renderiza de forma idêntica a uma versão sem espaços. A barra vertical em C|D foi escapada. Se todas as colunas ficarem no padrão, cada célula delimitadora vira :----, alinhada à esquerda.

Limites do modo de colagem

• Delimitador. O gerador testa vírgula, tabulação e ponto e vírgula nas primeiras linhas e usa o que divide as linhas no mesmo número de colunas de forma mais consistente; a vírgula vence os empates.
• Campos entre aspas. Um campo entre aspas duplas mantém suas vírgulas, como em "Smith, J.", e duas aspas duplas seguidas viram uma. Uma quebra de linha dentro de um campo entre aspas vira <br>, já que uma célula de tabela Markdown precisa ficar em uma linha só.
• O alinhamento usa contagem de caracteres. Caracteres largos, como texto CJK ou emojis, podem deixar o código-fonte com aparência irregular; a tabela renderizada não é afetada.
• Linhas irregulares são completadas com células vazias até a linha mais larga.

De qual ferramenta você precisa?

Perguntas frequentes

Como crio uma tabela Markdown?

Digite os cabeçalhos e as células na grade, ou mude para o modo de colagem e cole dados CSV ou separados por tabulação. O gerador escreve a linha de cabeçalho, a linha delimitadora e as linhas do corpo, e mostra uma pré-visualização renderizada para você conferir.

Como defino o alinhamento de colunas em uma tabela Markdown?

Escolha Esquerda, Centro ou Direita para a coluna. A escolha é escrita na linha delimitadora com dois-pontos: :--- para esquerda, :---: para centro e ---: para direita.

Posso converter CSV em uma tabela Markdown?

Sim. Cole linhas separadas por vírgula ou tabulação no modo de colagem. Campos entre aspas são tratados, então uma célula como "Smith, J." fica em uma única coluna, e uma quebra de linha dentro das aspas vira uma tag de quebra de linha.

Por que as colunas são preenchidas com espaços?

Para que as barras verticais fiquem alinhadas em texto simples. Renderizadores de Markdown ignoram os espaços extras, e o código preenchido é muito mais fácil de ler e editar.

O que acontece se meus dados tiverem uma barra vertical?

Ela é escapada como \|, para aparecer como barra vertical em vez de iniciar uma nova coluna.

Posso colocar quebras de linha ou listas em uma célula de tabela?

Não por esta ferramenta: as células têm uma linha só. A maioria dos renderizadores aceita uma tag <br> inline dentro de uma célula se você a acrescentar ao texto, mas isso é um recurso do renderizador, não parte da sintaxe de tabela.

Meus dados são enviados para algum lugar?

Não. A tabela é montada e pré-visualizada no seu navegador; nada é enviado ao CitationEasy.