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.
| Origem dos dados | O que copiar | Como as colunas são separadas |
|---|---|---|
| Excel ou Google Planilhas | O intervalo de células, com o cabeçalho. | Pelas tabulações do conteúdo copiado da planilha. |
| CSV | O texto do arquivo, incluindo a primeira linha. | Por vírgula ou ponto e vírgula, detectado pelo cabeçalho. |
| TSV | O 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çãoCafé;12,50;"Pacote; 250 g"
Essas duas linhas geram uma tabela com três colunas:
| Produto | Preço | Observação |
|---|---|---|
| Café | 12,50 | Pacote; 250 g |
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.
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.
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.
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.
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.
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.
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.
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.