5 formas de converter Markdown para PDF comparadas (Pandoc, VSCode, online)

Para um documento pontual, /markdown-to-pdf exige menos preparação. Pandoc é melhor para citações e publicação; VS Code e CLI servem a edição ou automação. Decida por recursos, reprodutibilidade e controle local.

A comparação usa capacidades documentadas atuais, não números fixos de cronômetro ou download, pois tempo de instalação e tamanho do navegador variam por sistema e versão.

Bom para: conversão pontual, realce, fórmulas, diagramas, sem instalar.

Como: abra /markdown-to-pdf, cole, clique em PDF.

Preparação e primeira execução: Varia conforme sistema operacional, motor PDF, cache e complexidade; teste no seu ambiente.

Pró: Sem instalação local e utilizável no navegador. Renderiza código, KaTeX, Mermaid, tabelas, imagens e tarefas. A saída gratuita leva marca; usuários autenticados têm atualmente cinco exportações sem marca no total.

Contra: limite 1 MB. Um arquivo por vez — para lotes veja Converter vários Markdown para PDF em lote.

Quando: 95 % das conversões pontuais.

Bom para: trabalhos acadêmicos, templates LaTeX próprios, citações e referências, saída multi-formato (PDF + DOCX + EPUB de uma fonte).

Como:

brew install pandoc
brew install --cask basictex  # or mactex (platform-dependent)
pandoc input.md -o output.pdf

Preparação e primeira execução: Varia conforme sistema operacional, motor PDF, cache e complexidade; teste no seu ambiente.

Pró: sólido, scriptável, templating LaTeX infinito. Citações nativas (--bibliography). Offline. Tipografia qualidade livro.

Contra: LaTeX ocupa conforme a plataforma. Saída padrão tem estética acadêmica. Templates customizados são difíceis. Realce precisa --syntax-highlighting e parece datado por padrões web. Mermaid exige filter plugin.

Quando: publica livro, tese, paper com bibliografia, ou mantém 3+ templates PDF versionados.

Bom para: quem escreve Markdown no VSCode o dia todo.

Como: instale o plugin "Markdown PDF" do yzane, clique direito → Markdown PDF: Export (pdf).

Preparação e primeira execução: Varia conforme sistema operacional, motor PDF, cache e complexidade; teste no seu ambiente.

Pró: um clique de onde você já está escrevendo. CSS configurável via user settings. Estilo padrão razoável.

Contra: primeiro export lento por causa do download. Estética só via CSS. KaTeX não funciona out of the box — precisa plugin Markdown+Math separado. Mermaid fica como código, não vira diagrama.

Quando: produz 5+ PDFs por semana e seu editor é VSCode.

Bom para: Markdown já renderizado no navegador (README do GitHub, GitLab Wiki, site de docs).

Como: ⌘+P ou Ctrl+P → "Salvar como PDF".

Preparação e primeira execução: Varia conforme sistema operacional, motor PDF, cache e complexidade; teste no seu ambiente.

Pró: já está lá. Sem instalação. Funciona em qualquer HTML renderizado.

Contra: quebras de página cortam tabelas e blocos de código imprevisivelmente. Realce perde cor no Firefox ao imprimir. Cabeçalho/rodapé padrão têm URL + página, geralmente precisam ser desligados manualmente. Não renderiza KaTeX ou Mermaid se a página origem não fizer.

Quando: precisa de um PDF agora de uma página Markdown já renderizada e detalhes ásperos não importam.

Bom para: pipelines de build, CI/CD, docs automatizadas.

Como:

npm install -g md-to-pdf
md-to-pdf input.md

Preparação e primeira execução: Varia conforme sistema operacional, motor PDF, cache e complexidade; teste no seu ambiente.

Pró: scriptável. YAML front-matter para tematizar por documento. Modo watch. Offline depois de instalado.

Contra: dependência Node + Chromium. Tematização só YAML + CSS, menos expressivo que Pandoc/LaTeX. Mermaid não out of the box — exige plugin markdown-it.

Quando: seu site de docs constrói PDFs em CI; quer PDFs no versionamento junto ao código.

Nota: evite o pacote antigo markdown-pdf (sem hífen) — sem atualização desde 2019, com avisos de segurança conhecidos. md-to-pdf é o sucessor mantido.

• Maioria → /markdown-to-pdf. Resposta para ~95 % dos casos.
• Acadêmicos com citações → Pandoc.
• Usuários VSCode diários → o plugin VSCode.
• DocOps / CI → md-to-pdf CLI.
• README do GitHub agora → imprimir do navegador, aceitar as asperezas.

A tentação com Markdown → PDF é over-engineering. Para um documento, não instale nada. Para mil, automatize com CLI. Raramente há meio-termo que justifique Pandoc fora do meio acadêmico.

Qual método preserva melhor o realce de código?

Os baseados em Chromium headless (/markdown-to-pdf, plugin VSCode, md-to-pdf CLI). Renderizam por Chromium real, então qualquer tema highlight.js/Prism passa. O --syntax-highlighting do Pandoc parece datado pelos padrões web. Mais em Markdown para PDF com realce de código.

Qual faz conversão em lote?

A CLI faz nativamente (md-to-pdf chapter*.md). Para o web tool, ver Converter Markdown para PDF em lote.

Por que md-to-pdf e não markdown-pdf?

markdown-pdf (sem hífen) está parado desde 2019, com avisos de segurança. md-to-pdf é o sucessor mantido.

Qual lida melhor com CJK / caracteres chineses?

O renderizador hospedado /markdown-to-pdf usa seu ambiente de fontes no servidor. Ferramentas Chromium locais usam fontes do runtime; Pandoc com XeLaTeX costuma exigir fonte CJK explícita como mainfont:. Teste os caracteres reais.

Qual sai mais barato em escala?

Para 100+ PDFs/semana, md-to-pdf em CI é praticamente grátis (só compute). Uso ocasional, web tool custa zero. Pandoc é grátis mas manter templates é custo oculto.

A escolha depende do volume. Um PDF → ferramenta web. Mil PDFs → CLI em CI. Livros com citações → Pandoc. Não pegue o martelo pesado antes de sentir a dor do leve.

Os limites e comandos acima foram verificados nestas fontes primárias atuais:

• https://markdowntoimage.com/markdown-to-pdf
• https://pandoc.org/MANUAL.html
• https://github.com/yzane/vscode-markdown-pdf
• https://github.com/simonhaenisch/md-to-pdf

Abra MarkdownToImage, renderize Markdown e escolha o formato adequado. Antes de automatizar um lote, teste um documento representativo.