Gerador de tabela Markdown

Cole dados do Excel, do Google Planilhas ou de um CSV e copie a tabela em Markdown. Você também pode preencher as células ou editar uma tabela Markdown pronta, com prévia enquanto faz os ajustes.

#
A
B
C
H
1
2

Markdown para copiar

| Parâmetro | Tipo | Descrição |
| --- | :---: | --- |
| pagina | inteiro | Número da página |
| busca | texto | Termo de busca |

Prévia da tabela

3 linhas × 3 colunas

Continue com este documento

Leve seu Markdown atual para o próximo passo, incluindo as últimas alterações.

Do Excel para Markdown: copie, cole e ajuste

A tabela já está no Excel ou no Google Planilhas (Google Sheets)? Selecione as células que quer levar para a documentação, incluindo os títulos das colunas, e copie. No editor acima, clique em Colar tabela. A primeira linha vira o cabeçalho e os dados substituem a tabela atual.

Confira a prévia, ajuste o que precisar e use o ícone de copiar ao lado de Markdown para copiar. Para acrescentar um intervalo a uma tabela em edição, selecione a célula onde os dados devem começar e cole pelo teclado. Isso preenche as células a partir daquela posição, sobrescrevendo o conteúdo da área colada.

A conversão de Excel para Markdown aqui funciona por cópia de células, sem upload de arquivos .xlsx. Se a origem for um arquivo CSV ou TSV, abra-o e copie o conteúdo como texto.

O que copiar de cada origem para gerar a tabela Markdown
Origem dos dadosO que copiarComo as colunas são separadas
Excel ou Google PlanilhasO intervalo de células, com o cabeçalho.Pelas tabulações do conteúdo copiado da planilha.
CSVO texto do arquivo, incluindo a primeira linha.Por vírgula ou ponto e vírgula, detectado pelo cabeçalho.
TSVO texto com as tabulações originais.Por tabulação, sem trocar por espaços.

CSV para Markdown com ponto e vírgula e valores como 12,50

Um preço com vírgula decimal não deve virar duas colunas. Neste exemplo, o ponto e vírgula separa os campos, enquanto as aspas mantêm Pacote; 250 g dentro de uma única célula. Copie as duas linhas e use Colar tabela:

Produto;Preço;Observação
Café;12,50;"Pacote; 250 g"

Essas duas linhas geram uma tabela com três colunas:

Resultado do CSV com ponto e vírgula, vírgula decimal e um campo entre aspas
ProdutoPreçoObservação
Café12,50Pacote; 250 g
01

E se o CSV usar vírgula como separador?

Coloque entre aspas os campos que contêm vírgulas. Com o cabeçalho Produto,Preço, por exemplo, a linha Café,"12,50" mantém o preço em uma célula. O editor detecta vírgula ou ponto e vírgula pela primeira linha; confira se o cabeçalho usa o mesmo separador que o restante do arquivo.

Editor de tabela Markdown para atualizar o que já está pronto

Precisa incluir um parâmetro na documentação ou mudar um valor sem refazer a tabela? Copie a tabela Markdown completa, com o cabeçalho, a linha de hífens e os dados, e clique em Colar tabela. O editor reconhece as colunas e os alinhamentos; esse botão substitui o conteúdo atual.

Edite as células, acrescente linhas ou remova uma coluna pelo ícone de lixeira. Depois, copie a nova versão para o documento. Para importar como Markdown, mantenha a linha separadora abaixo do cabeçalho: ela faz parte da estrutura que o editor reconhece.

A prévia mostra a estrutura, o alinhamento e as quebras de linha. Formatações como negrito, links e código dentro das células devem ser conferidas no destino. Para revisar a tabela junto com o restante do documento, use a prévia de Markdown em tempo real.

Como criar uma tabela Markdown do zero

Não tem dados para colar? Use o gerador de tabelas Markdown como uma pequena planilha: substitua o exemplo e deixe o editor montar as barras e os hífens.

01

Preencha o cabeçalho e as linhas

A primeira linha contém os títulos das colunas. Digite seus dados nas linhas seguintes e use Adicionar linha ou Adicionar coluna quando precisar de mais espaço.

02

Escolha o alinhamento de cada coluna

Os três botões acima de cada coluna alinham o conteúdo à esquerda, ao centro ou à direita. Confira a distribuição dos dados na Prévia da tabela.

03

Copie o código para o documento

Use o ícone de copiar ao lado de Markdown para copiar. Leve esse código para o seu arquivo Markdown e confira a renderização no destino. Para consultar outras regras de formatação, veja o guia rápido de sintaxe Markdown. O botão com a seta circular restaura a tabela de exemplo e descarta as edições atuais.

Tabela Markdown no README: documente os parâmetros da sua API

O exemplo do editor já traz uma tabela para documentação de API: parâmetro, tipo e descrição. Se também precisar indicar quais campos são obrigatórios, copie o modelo completo abaixo. Neste exemplo de consulta, busca é obrigatório e pagina é opcional; ajuste os nomes, tipos e regras à sua API.

| Parâmetro | Tipo | Obrigatório | Descrição | | --- | --- | :---: | --- | | busca | texto | Sim | Termo de busca | | pagina | inteiro | Não | Número da página; padrão: 1 |

Para adaptar o modelo, selecione as quatro linhas de código, copie e clique em Colar tabela. O modelo substitui a tabela atual e já inclui a coluna Obrigatório.

Cole a saída no README.md, com uma linha em branco antes da tabela e fora de blocos de código. Confira o resultado na prévia do GitHub. Se estiver editando no VS Code, cole o código no arquivo Markdown e use a prévia do documento para revisar.

O mesmo fluxo serve para comparar recursos, listar versões ou organizar anotações. Em outros editores, como o Obsidian, confira a tabela no modo de leitura. O suporte a HTML e outros detalhes de renderização depende do destino.

Como alinhar e formatar uma tabela Markdown

Se a tabela parece desalinhada, confira primeiro onde está o problema: no texto exibido ou nas barras do código. São ajustes diferentes.

01

Para mudar a posição do texto, use os botões da coluna

A linha separadora registra o alinhamento: o gerador usa --- para esquerda, :---: para centro e ---: para direita. Numa coluna de preços, por exemplo, alinhar à direita ajuda a comparar os valores na tabela exibida.

02

Para organizar o código, não precisa completar com espaços

As barras podem ficar em posições diferentes no arquivo-fonte quando os textos têm tamanhos diferentes. Isso não impede a tabela de funcionar no GitHub. O gerador mantém as colunas e a linha separadora sem preencher as células com espaços extras.

03

Para escrever uma barra vertical na célula, preserve o escape

Ao digitar A | B em uma célula, a saída será A \| B. A barra invertida evita que o conteúdo abra outra coluna. Se estiver corrigindo uma tabela manualmente antes de colar, mantenha esse escape nas barras que fazem parte dos dados. Veja também os exemplos de alinhamento e escape na documentação do GitHub sobre tabelas.

04

Se a tabela aparecer como texto, confira a linha separadora

O cabeçalho e a linha separadora precisam ter o mesmo número de células. Neste exemplo incorreto, o cabeçalho tem duas células, mas a linha de hífens tem apenas uma; por isso, o GitHub não reconhece a tabela:

| Parâmetro | Tipo | | --- | | busca | texto |

Acrescente a segunda célula à linha separadora para corrigir a estrutura:

| Parâmetro | Tipo | | --- | --- | | busca | texto |

A especificação de tabelas do GitHub Flavored Markdown descreve essa estrutura de cabeçalho e separador. A sintaxe de tabelas GFM não oferece mesclagem de células; se precisar desse layout, use outro formato, como HTML, em um destino que o aceite.

Dúvidas sobre tabelas Markdown

Respostas para quando a tabela aparece como texto, a colagem falha ou você precisa de um layout diferente.

Por que minha tabela Markdown não aparece no GitHub?

Se ela aparece como texto com barras, veja se foi colada dentro de um bloco de código delimitado por crases. Cole a saída diretamente no documento, fora desse bloco, e deixe uma linha em branco antes da tabela. Mantenha também a linha de hífens logo abaixo do cabeçalho. Confira se o cabeçalho e a linha separadora têm o mesmo número de células. Se surgirem colunas extras, confira se as barras verticais dentro dos dados têm uma barra invertida antes delas.

Como quebrar linha dentro de uma célula em Markdown?

No código Markdown, use <br> dentro da célula se o destino aceitar essa tag HTML. Ao colar uma tabela Markdown com <br>, este editor reconhece a quebra e a preserva na saída. Quebras de linha presentes em campos CSV entre aspas também viram <br>. Confira o resultado no destino; pressionar Enter e dividir uma linha da tabela no arquivo-fonte pode quebrar a estrutura.

É possível mesclar células em uma tabela Markdown?

A sintaxe de tabelas do GitHub Flavored Markdown não tem um recurso para mesclar células. O gerador mantém uma célula por coluna em cada linha. Se o layout exigir mesclagem, será preciso usar outro formato, como uma tabela HTML, em um destino que aceite esse tipo de conteúdo.

Como criar uma tabela Markdown sem cabeçalho?

Deixe vazias as células da primeira linha para não mostrar títulos. A estrutura do cabeçalho e a linha separadora continuam no código porque fazem parte das tabelas do GitHub Flavored Markdown. Isso deixa os títulos em branco, mas não elimina a linha de cabeçalho da tabela.

O botão Colar tabela não funciona. Como colar os dados?

O navegador pode bloquear a leitura da área de transferência. Autorize o acesso quando ele pedir ou selecione a primeira célula do editor e cole o intervalo pelo teclado. A colagem em uma célula começa naquela posição e pode sobrescrever os dados existentes. Para CSV, copie o texto com o cabeçalho e as linhas de dados.

Qual é o limite de linhas e colunas?

São até 100 linhas, contando o cabeçalho, e 20 colunas. Ao usar Colar tabela com um conjunto maior, ficam apenas as primeiras 100 linhas e 20 colunas. Ao colar a partir de uma célula, os dados também ficam restritos a esses limites. Recorte o intervalo antes de copiar ou divida o conteúdo em tabelas menores.

Onde os dados da tabela são processados?

A leitura dos dados colados, a edição, a prévia da tabela e a geração do Markdown acontecem nesta aba do navegador. Os botões de copiar e colar acessam a área de transferência. A permissão de leitura depende do navegador.

Leve os dados para o seu README

Cole a planilha ou a tabela pronta, faça os ajustes e copie o Markdown para a documentação.