Resposta rápida: Pandoc converte Markdown, DOCX, PDF, HTML, LaTeX e EPUB com um único comando, grátis e open-source. Veja como instalar, usar e se vale a pena em 2026.
Resposta rápida
Atualizado em 01/07/2026
Pandoc é um conversor universal de documentos de linha de comando, open-source sob licença GPL, criado por John MacFarlane e atualmente na versão 3.x. Ele converte entre mais de 40 formatos — Markdown, DOCX, PDF, HTML, LaTeX, EPUB, ODT e outros — preservando estrutura, notas de rodapé e referências cruzadas.
Diferente de conversores online que só fazem trocas simples de formato, o Pandoc entende a estrutura semântica do documento: títulos viram títulos, listas viram listas, citações viram citações, independente da sintaxe de origem ou destino. Isso é possível porque ele usa um modelo de documento interno (uma espécie de “AST” — árvore de sintaxe abstrata) para o qual todo formato de entrada é traduzido antes de ser reescrito no formato de saída. É esse design que separa Pandoc de ferramentas como o simples “Salvar como” do Word ou conversores web genéricos: ele foi construído para escrita técnica e acadêmica, onde bibliografia, numeração e metadados precisam sobreviver à conversão.
O que é o Pandoc e como ele funciona?
Pandoc é uma ferramenta de linha de comando escrita em Haskell. Você roda um comando no terminal, aponta um arquivo de entrada e um formato de saída, e ele faz a conversão. Não tem interface gráfica oficial — a experiência é 100% via terminal (embora existam GUIs de terceiros, como o Pandoc GUI ou plugins de editores como VS Code).
O funcionamento é em duas etapas internas: primeiro um leitor (reader) interpreta o arquivo de origem e o transforma no modelo interno do Pandoc; depois um escritor (writer) pega esse modelo e gera o arquivo de saída no formato pedido. Como os dois lados são desacoplados, adicionar suporte a um novo formato não exige reescrever tudo — só um novo reader ou writer. É por isso que a lista de formatos suportados é tão grande.
Pandoc é realmente grátis?
Sim. Pandoc é distribuído sob licença GPL (GNU General Public License), código aberto, sem versão paga, sem “Pro” com recursos trancados. Todo o código-fonte está disponível publicamente e pode ser auditado por qualquer pessoa. É mantido por uma comunidade ativa de colaboradores no GitHub, com releases frequentes.
Como instalar o Pandoc no Windows, Mac e Linux?
A instalação varia por sistema, mas é simples em todos:
- Windows: baixe o instalador `.msi` direto do site oficial pandoc.org/installing.html, ou instale via `winget install pandoc` / `choco install pandoc` no terminal.
- macOS: via Homebrew com `brew install pandoc`, ou baixando o pacote `.pkg` do site oficial.
- Linux: a maioria das distros tem pacote nos repositórios (`apt install pandoc` no Ubuntu/Debian), mas a versão do repositório costuma ser mais antiga que a do site oficial — para a versão mais recente, baixe o `.deb` ou `.tar.gz` direto do GitHub releases.
Depois de instalado, teste no terminal com pandoc --version. Para converter PDF é preciso também ter um motor LaTeX instalado (como MiKTeX no Windows ou TeX Live no Linux/Mac), já que o Pandoc gera PDF via LaTeX por padrão.
Quais formatos o Pandoc converte?
A lista é extensa, mas os pares mais usados no dia a dia são:
- Markdown ↔ DOCX (o caso de uso mais comum: escrever em Markdown puro e entregar em Word para revisão)
- Markdown → PDF (via LaTeX, HTML+CSS ou wkhtmltopdf)
- Markdown ↔ HTML
- Markdown → EPUB (para criar e-books a partir de texto simples)
- LaTeX ↔ Markdown
- DOCX → Markdown (útil para extrair texto limpo de documentos do Word)
- ODT, RTF, reStructuredText, MediaWiki, Jupyter Notebook (.ipynb), entre outros
Um comando típico é: pandoc artigo.md -o artigo.docx — simples assim, sem menus, sem cliques.
Quais são os casos de uso reais do Pandoc?
Escritores técnicos usam Pandoc para manter documentação em Markdown no controle de versão (Git) e gerar PDF ou DOCX só na hora de entregar. Acadêmicos usam para escrever artigos científicos com citações via BibTeX/CSL e exportar direto para o formato exigido pela revista (geralmente DOCX ou PDF com norma ABNT/APA). Desenvolvedores usam para transformar READMEs em documentação HTML ou gerar manuais em PDF a partir de arquivos Markdown do repositório. Editores de livros independentes usam para gerar EPUB e MOBI a partir de um manuscrito único em Markdown, evitando manter várias versões do mesmo texto.
Quais são os erros mais comuns de quem começa a usar o Pandoc?
O erro número um é tentar gerar PDF sem ter instalado um motor LaTeX — o Pandoc retorna um erro dizendo que não encontrou pdflatex ou xelatex, e quem não sabe disso perde tempo achando que o programa está quebrado. A solução é instalar o MiKTeX (Windows) ou TeX Live (Linux/Mac), ou alternativamente gerar via --pdf-engine=wkhtmltopdf, que dispensa LaTeX mas perde qualidade tipográfica em fórmulas matemáticas.
Outro erro comum é ignorar acentuação e caracteres especiais: arquivos Markdown salvos em codificação diferente de UTF-8 geram símbolos quebrados na saída (o clássico “ção” no lugar de “ção”). A prática correta é sempre salvar arquivos-fonte em UTF-8 sem BOM antes de rodar o Pandoc, especialmente em projetos escritos em português. Por fim, muita gente tenta converter um DOCX complexo (com múltiplas colunas, caixas de texto flutuantes, campos de formulário) esperando fidelidade total — o Pandoc extrai bem o texto e a estrutura lógica, mas layout muito visual e não-linear de um DOCX raramente sobrevive 100% intacto, porque o modelo interno do Pandoc é pensado para fluxo de texto, não para posicionamento livre de elementos.
Pandoc vs alternativas: qual escolher?
| Ferramenta | Licença | Interface | Curva de aprendizado | Ideal para |
|---|---|---|---|---|
| Pandoc | GPL (gratuito) | Linha de comando | Média/alta | Conversão em massa, automação, docs técnicos |
| LibreOffice (Salvar Como) | MPL 2.0 (gratuito) | Gráfica | Baixa | Conversão pontual de 1 documento |
| Conversores online (CloudConvert etc.) | Freemium | Web | Baixa | Arquivo único, sem instalar nada |
| Microsoft Word | Pago (licença/assinatura) | Gráfica | Baixa | Edição visual, não conversão em lote |
Como personalizar a saída do Pandoc com templates e filtros?
Um dos recursos mais poderosos e menos conhecidos do Pandoc é o sistema de templates. Cada writer (DOCX, HTML, LaTeX, PDF) tem um template padrão embutido, mas você pode extrair esse template com pandoc -D latex (ou html, docx etc.) e editá-lo para controlar exatamente cabeçalho, rodapé, numeração de página, fonte padrão e margens. Isso é o que permite, por exemplo, gerar um PDF acadêmico já formatado em ABNT sem tocar em nenhum editor visual depois da conversão — o template resolve isso uma vez, e todo artigo futuro sai formatado igual.
Outro recurso avançado são os filtros (filters) e Lua filters: pequenos scripts que interceptam o documento no meio do processo de conversão e alteram elementos específicos — trocar todas as imagens por uma versão com legenda automática, numerar figuras e tabelas de forma consistente, ou remover comentários de revisão antes de gerar a versão final. Isso transforma o Pandoc de “conversor” em uma pequena esteira de processamento de documentos, algo que ferramentas gráficas simplesmente não oferecem.
Como o Pandoc lida com metadados e front matter?
Documentos em Markdown processados pelo Pandoc podem começar com um bloco de metadados YAML (delimitado por ---), onde você define título, autor, data, idioma, e até variáveis customizadas usadas pelo template. Esse mesmo bloco é o que ferramentas como Hugo usam como “front matter” — não por coincidência, já que ambos herdam a convenção de metadados estruturados no topo do arquivo Markdown. Isso significa que um arquivo pensado para virar post de blog no Hugo pode, com pequenos ajustes, também virar PDF ou DOCX via Pandoc, sem duplicar cabeçalho ou informações de autoria.
Quando NÃO usar o Pandoc / limitações
Pandoc não é para quem tem medo de terminal — não existe versão com interface gráfica oficial, e cada conversão exige digitar um comando (ou criar um script/Makefile para repetir). Também não é a ferramenta certa se você precisa de layout visual pixel-perfect controlado por mouse: para diagramação fina de PDF, um editor como Scribus faz mais sentido. A geração de PDF depende de uma instalação de LaTeX (MiKTeX/TeX Live), que sozinha pode passar de 1 GB — isso surpreende quem espera algo “leve”. E, embora ele preserve bem estrutura e texto, formatação visual muito específica (cores exatas, fontes customizadas) exige templates adicionais, não é automático.
Pandoc vale a pena em 2026?
Sim, principalmente para quem já trabalha com Markdown ou versiona documentação em Git. Com o crescimento de fluxos de “docs as code” e geradores de site estático como o Hugo, o Pandoc se tornou peça de infraestrutura silenciosa: converte o mesmo texto para blog, PDF de entrega e e-book sem duplicar trabalho. Para quem escreve código e documentação lado a lado, combinar Pandoc com um editor como o VS Code (que tem extensões de preview Markdown) cobre praticamente todo o ciclo de escrita técnica sem depender de suítes de escritório pesadas.
Perguntas frequentes sobre o Pandoc
Pandoc precisa de internet para funcionar?
Não. Depois de instalado, o Pandoc roda 100% offline — toda a conversão acontece localmente na sua máquina, sem enviar arquivos para servidores externos. Isso é uma vantagem de privacidade sobre conversores online.
Pandoc consegue converter PDF para Word?
Conversão de PDF como origem é limitada, porque PDF é um formato voltado a impressão, não a estrutura de texto. O Pandoc funciona muito melhor no sentido contrário: gerar PDF a partir de Markdown, LaTeX ou DOCX, não extrair texto estruturado de dentro de um PDF já pronto.
Preciso saber programar para usar o Pandoc?
Não precisa saber programar, mas precisa estar confortável abrindo um terminal e digitando comandos simples. Não há necessidade de aprender Haskell (a linguagem em que o Pandoc é escrito) para usá-lo no dia a dia.
Pandoc consegue gerar bibliografia automática em ABNT ou APA?
Sim. Combinando Pandoc com um arquivo de referências BibTeX e um estilo CSL (Citation Style Language) específico, ele formata citações e bibliografia automaticamente no padrão exigido, incluindo normas acadêmicas brasileiras adaptadas via CSL customizado.
Existe interface gráfica para o Pandoc?
Não oficialmente, mas existem projetos de terceiros como Pandoc GUI, Rmarkdown no RStudio e extensões de editores (VS Code, Zettlr) que colocam uma camada visual sobre o Pandoc, chamando ele nos bastidores via linha de comando.
Veredicto
O Pandoc vale muito a pena para escritores técnicos, acadêmicos e desenvolvedores que já pensam em texto como dado estruturado — Markdown como fonte única, exportada para onde for preciso. Não vale a pena para quem só precisa converter um documento isolado de vez em quando e prefere abrir o LibreOffice e clicar em “Salvar como”. Para uso recorrente e automatizável, é insubstituível e gratuito para sempre.
Receba os melhores programas GRÁTIS por e-mail — 1 e-mail/semana
Software gratuito, open-source e alternativas legais a programas pagos. Sem spam, sem pirataria. Cancela quando quiser. Ao assinar você ganha nosso Kit Essencial: 30 Programas Grátis que Substituem Software Pago.
1 comentário