Tabelas em Markdown: do Excel ou CSV a um PDF limpo

Por Fazt · Atualizado em 7 de outubro de 2026

Muitas vezes a tabela é o motivo de um documento existir: a lista de preços para um cliente, a programação de um treinamento, o anexo de dados de um relatório. Os números costumam estar em uma planilha, e o resultado precisa ser um PDF. O Markdown fica bem no meio do caminho: as tabelas são texto puro que você edita e guarda com controle de versão, e são impressas como tabelas limpas e com bordas. Este guia passa pela sintaxe, pela conversão a partir de Excel ou CSV, pelo comportamento das tabelas no papel e pelo que fazer quando uma delas não aparece.

A sintaxe em um minuto

O editor de Markdown segue as regras de tabelas do GitHub Flavored Markdown: linhas de células separadas por barras verticais.

| Plano    | Usuários | Preço mensal |
| :------- | :------: | -----------: |
| Básico   | 1        | R$ 29,00     |
| Equipe   | 10       | R$ 149,00    |
| Empresa  | 50       | R$ 590,00    |

A primeira linha é o cabeçalho. Toda tabela tem exatamente um, impresso em negrito sobre um fundo sombreado.
A segunda linha é a de separação: pelo menos um hífen por coluna e exatamente o mesmo número de colunas do cabeçalho.
Os dois-pontos definem o alinhamento: :--- à esquerda (o padrão), :---: centralizado e ---: à direita. Alinhe preços e quantidades à direita para que os algarismos fiquem em coluna.
As barras das pontas são opcionais, mas ajudam a achar erros. As colunas não precisam estar alinhadas no texto-fonte; o preenchimento serve só para os seus olhos.
Deixe uma linha em branco antes e depois da tabela.

As regras completas estão na especificação do GitHub Flavored Markdown.

O que cabe dentro de uma célula

As células aceitam Markdown em linha: negrito, itálico, tachado, `código`, links e chamadas de notas de rodapé. Três pontos pedem cuidado:

Uma barra vertical literal precisa ser escrita como \|; senão, ela começa uma nova célula. Isso vale também dentro de crases.
Quebras de linha: cada linha da tabela ocupa uma única linha do texto-fonte, então apertar Enter encerra a linha. Use <br> para quebrar a linha dentro de uma célula.
Elementos de bloco como listas de verdade, vários parágrafos ou blocos de código não cabem em uma célula. Simule uma lista curta com <br> ou leve uma observação longa para uma nota de rodapé, que é impressa no fim do documento.

| Passo | Comando | Observações |
| ----- | ------- | ----------- |
| 1 | `npm install` | Baixa as dependências |
| 2 | `sort registro.txt \| uniq` | Remove linhas repetidas[^1] |
| 3 | `npm run build` | Leva cerca de um minuto<br>O resultado vai para **dist/** |

[^1]: A barra invertida mantém a barra vertical dentro da célula.

Do Excel para uma tabela Markdown

Abra o conversor de Excel para Markdown e solte sua pasta de trabalho (.xlsx, .xlsm, .xlsb ou o antigo .xls). Ela é lida dentro do navegador, então números confidenciais não saem do seu computador. O Markdown aparece em uma caixa de texto onde você pode editá-lo antes de Copiar, Baixar .md ou clicar em Abrir no editor → PDF.

Veja o que a conversão faz com tudo o que uma planilha pode conter:

Abas: cada aba vira uma tabela própria, precedida de um título ## Nome da aba quando há mais de uma. Abas vazias e ocultas são ignoradas, assim como linhas e colunas ocultas: ocultar é um jeito rápido de deixar de fora colunas auxiliares.
Linha de cabeçalho: a primeira linha só vira cabeçalho se tiver um valor em todas as colunas. Com um título acima da tabela, um título em células mescladas ou uma coluna sem nome, você recebe uma linha de cabeçalho vazia e os cabeçalhos reais vão parar no corpo. Coloque os nomes das colunas na linha 1 e dê nome a todas.
Linhas vazias no meio dos dados são mantidas como linhas em branco (| | | |). Apague-as na planilha ou na caixa de texto.
Fórmulas saem como o último valor calculado. Um arquivo gerado por outro programa que nunca chegou a calculá-las pode mostrar células vazias: abra-o no Excel e salve uma vez.
Formatos de número são aplicados: símbolos de moeda, porcentagens, separadores de milhar e casas decimais aparecem formatados (R$ 1,234.50, 15%), mas sempre com vírgula para milhar e ponto para decimais, mesmo que o seu Excel mostre R$ 1.234,50.
Datas e horas são escritas no formato ISO, como 2026-03-01 ou 2026-11-20 14:30:00, mesmo que a célula mostre 01/03/2026.
Células mescladas mantêm o valor na célula superior esquerda; as que ela cobria ficam vazias.
O que se perde: negrito, cores, bordas e gráficos. Hiperlinks mantêm só o texto visível, uma quebra de linha dentro da célula vira espaço e caracteres como * são escapados, então um texto que parece Markdown é impresso literalmente.

Todas as colunas saem alinhadas à esquerda. Antes de imprimir, troque a linha de separação para ---: embaixo das colunas numéricas.

A partir de CSV

CSV é o que quase toda ferramenta exporta: Google Sheets, Numbers, sistemas de contabilidade, bancos de dados e os bancos de dados do Notion. Solte o arquivo no conversor de CSV para Markdown:

O separador é detectado automaticamente: vírgula, ponto e vírgula (comum onde a vírgula é o separador decimal, como no Brasil) e tabulação funcionam.
Valores entre aspas que contêm o separador ficam em uma única célula, e as barras verticais são escapadas como \|.
CSV é texto puro, então os valores são mantidos exatamente como estão escritos: as datas não mudam de formato e os zeros à esquerda continuam lá (0012). Linhas em branco são ignoradas.
A regra do cabeçalho é a mesma do Excel: a primeira linha precisa dar nome a todas as colunas.
Arquivos terminados em .tsv ou .txt não são reconhecidos. Mude a extensão para .csv antes de soltá-los.

Quer as datas como aparecem na tela, e não no formato ISO? Salve essa aba como CSV no seu programa de planilhas, que normalmente grava os valores como são exibidos, e converta o CSV.

Levando a tabela para o seu documento

Abrir no editor → PDF substitui o que estiver no editor, o que é ótimo quando o documento é só a tabela. Para incluí-la em um documento que você já tem, clique em Copiar e cole no lugar certo, com uma linha em branco antes e depois.

Como as tabelas são impressas

No PDF, as tabelas ocupam toda a largura do texto, com bordas finas, a linha de cabeçalho sombreada e letra um pouco menor que a do corpo.

Tabelas longas continuam nas páginas seguintes, e uma linha nunca é dividida entre duas páginas. Com Baixar PDF, a linha de cabeçalho se repete no topo de cada página (no Chrome, no Edge e no Firefox). O PDF rápido salva as páginas como imagens e não a repete.
Sombreado do cabeçalho: se sair em branco, ative Gráficos de plano de fundo na janela de impressão.
Tabelas largas: as colunas encolhem e o texto quebra em várias linhas, mas uma URL, um código ou uma palavra longa sem espaços não pode ser quebrada: empurra a tabela para além da margem direita e o PDF a corta. Se a tabela passar da borda na pré-visualização, no papel também vai passar.
Orientação: não há opção de paisagem. As páginas são A4 ou Letter (carta), em retrato.

Para fazer uma tabela larga caber, tente nesta ordem: reduza o Tamanho da fonte no painel Estilo (de 9 a 14 pt; vale para o documento inteiro), mude as Margens para Estreitas (12 mm em vez de 20), troque URLs longas por um texto de link curto como [relatório](https://…), abrevie os nomes das colunas e explique-os abaixo da tabela e, em último caso, divida a tabela em duas ou troque linhas por colunas. Para uma tabela grande começar em uma página nova, coloque  sozinho em uma linha logo antes dela.

Quatro receitas

Comparativo

Opções nas colunas e critérios nas linhas: três ou quatro opções cabem em uma página em retrato.

| | Fornecedor A | Fornecedor B | Fornecedor C |
| --- | :---: | :---: | :---: |
| Preço por unidade | R$ 4,20 | R$ 3,95 | R$ 4,10 |
| Entrega | 3 dias | 10 dias | 5 dias |
| Devolução grátis | Não | Não | Sim |
| **Veredito** | Mais rápido | Mais barato | **Melhor custo-benefício** |

Lista de preços

Alinhe os preços à direita, destaque o total em negrito e leve as condições para uma nota de rodapé.

| Serviço | Unidade | Preço |
| --- | --- | ---: |
| Auditoria de site | por site | R$ 1.800,00 |
| Redação | por página | R$ 450,00 |
| Manutenção[^1] | por mês | R$ 350,00 |
| **Total do primeiro mês** | | **R$ 2.600,00** |

[^1]: Prazo mínimo de três meses.

Programação

Horários na primeira coluna e dias no topo; <br> mantém uma entrada de duas linhas em uma só célula.

| Horário | Segunda | Terça |
| --- | --- | --- |
| 09:00 | Reunião de abertura | Oficina: modelo de dados |
| 11:00 | Entrevistas<br>Salas 2 e 3 | Continuação da oficina |
| 14:00 | Visita técnica | Encerramento e próximos passos |

Anexo de dados

Deixe um resumo no corpo e os dados completos no fim, depois de uma quebra de página, onde o cabeçalho repetido faz mais diferença.

<!-- pagebreak -->

## Anexo A. Vendas mensais por região

| Mês | Sudeste | Sul | Total |
| --- | ---: | ---: | ---: |
| Janeiro | 12.400 | 9.800 | 22.200 |
| Fevereiro | 11.950 | 10.300 | 22.250 |

Quando a tabela não é a ferramenta certa

Células que precisam de parágrafos ou listas: dê a cada item um título ### com uma lista embaixo.
Uma única coluna de valores é, simplesmente, uma lista.
Mais de sete ou oito colunas, ou milhares de linhas: resuma e compartilhe a planilha à parte.
Diagramação, como blocos de texto lado a lado: tabelas são para dados.

Solução de problemas

A tabela aparece como texto com barras. Conte as colunas: a linha de separação precisa ter exatamente tantas células quanto o cabeçalho, cada uma com pelo menos um hífen. Verifique também se a tabela não está recuada com quatro espaços (vira bloco de código) nem grudada em um item de lista sem linha em branco, que a engole.
Faltam dados em uma linha. Células além do número de colunas do cabeçalho são descartadas sem aviso; linhas mais curtas são completadas com células vazias. A culpada costuma ser uma | sem escape no texto.
A tabela para no meio e o resto é impresso como linhas com barras: há uma linha em branco dentro da tabela.
Uma frase virou linha da tabela. O texto na linha logo depois de uma tabela é lido como mais uma linha. Adicione uma linha em branco.
Parte de uma célula parece uma fórmula. O editor renderiza como LaTeX o que fica entre cifrões. Valores em reais, como R$ 10,00, não são afetados, mas uma célula como de 5 $ a 10 $ vira fórmula. Escape o primeiro cifrão: 5 \$.
A tabela convertida tem o cabeçalho vazio. A linha 1 da planilha era um título ou tinha uma célula vazia. Corrija a planilha e converta de novo, ou apague a primeira linha vazia e as linhas de título e suba o cabeçalho real para cima da linha ---.
Alguns códigos mudaram. A tipografia inteligente transforma -- em meia-risca (–) e aspas retas em curvas. Coloque códigos de produto e comandos entre crases para mantê-los exatamente como foram digitados.

O guia de Markdown cobre tudo o mais que o editor suporta.