5 formas de converter Markdown para PDF comparadas (Pandoc, VSCode, online)
Compare cinco métodos de Markdown para PDF com uma amostra comum e escolha lotes no navegador, editor, CLI local ou Pandoc conforme a entrega.
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.
Vantagens: Sem instalação local; suporta realce, KaTeX, Mermaid, tabelas, imagens e tarefas. Após iniciar sessão, dispõe de cinco exportações no navegador sem marca de água, no total, seguidas de exportações ilimitadas com marca. O Creator custa 9 USD/mês e inclui exportações ilimitadas no navegador sem marca; o passe de 1 USD cobre uma. Os créditos da API são separados.
Âmbito: A página PDF individual limita a entrada a 1 MB. A ferramenta separada de lotes pagos cria um ZIP com saídas individuais. Veja os limites e as alternativas de combinação no guia de lotes.
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
Pró: sólido, scriptável, templating LaTeX infinito. Citações nativas (--bibliography). Offline. Tipografia qualidade livro.
Limitações: Requer motor PDF, fontes e modelos. Use --syntax-highlighting para escolher o tema e confirme a saída com o motor selecionado. Prepare Mermaid como imagens ou configure um processo de pré-processamento adequado.
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).
Vantagens: Exportação no editor com CSS e realce configuráveis. O README atual documenta Mermaid e KaTeX; confirme a versão instalada e a configuração.
Limitações: A extensão precisa de um navegador compatível; definições e CSS determinam a saída. Uma extensão de pré-visualização não participa necessariamente na exportação PDF. Teste fórmulas, Mermaid, fontes e quebras no ficheiro.
Quando usar: Já escreve e revê no VS Code e pretende manter as definições de exportação no mesmo processo.
Bom para: Markdown já renderizado no navegador (README do GitHub, GitLab Wiki, site de docs).
Como: ⌘+P ou Ctrl+P → "Salvar como PDF".
Pró: já está lá. Sem instalação. Funciona em qualquer HTML renderizado.
Limitações: A saída depende do CSS de impressão e das suas definições. Verifique fundos, cores, cabeçalhos, rodapés e quebras. As fórmulas e os diagramas devem estar renderizados na página.
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
Pró: scriptável. YAML front-matter para tematizar por documento. Modo watch. Offline depois de instalado.
Limitações: Requer Node.js e um ambiente de navegador. A personalização usa configuração e CSS. Confirme as extensões Markdown necessárias; se um diagrama não for renderizado, prepare-o como imagem.
Quando: seu site de docs constrói PDFs em CI; quer PDFs no versionamento junto ao código.
Use o nome exato da documentação indicada. md-to-pdf e markdown-pdf são pacotes diferentes; verifique a versão e os avisos antes de instalar.
| Método | Preparação local | Primeira exportação | Realce | Fórmulas | Mermaid | Utilização indicada |
|---|---|---|---|---|---|---|
/markdown-to-pdf | Sem instalação | Pedido no navegador | Suportado | KaTeX | Suportado | Documentos individuais |
| Pandoc | Motor PDF e fontes | Depende do ambiente | Temas de sintaxe | Depende do motor | Pré-processamento | Livros e citações |
| VS Code Markdown PDF | Extensão e renderizador | Depende do ambiente | Configurável | KaTeX | Suportado; configurar ambiente | Processo no editor |
| Impressão no navegador | Página já renderizada | Diálogo de impressão | Depende da página | Depende da página | Depende da página | Páginas existentes |
md-to-pdf CLI | Node.js e navegador | Depende do ambiente | Configurável | Verificar configuração | Preparar imagens | Compilações CI |
- 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-pdfCLI. - README do GitHub agora → imprimir do navegador, aceitar as asperezas.
Automatize quando precisar de reconstruir por calendário ou commit. Para grupos ocasionais, os lotes no navegador dispensam configuração local. O Pandoc adequa-se a um documento ordenado com estrutura editorial, citações e modelo controlado.
Qual método preserva melhor o realce de código?
Os métodos Chromium podem preservar o realce web com tema e definições de impressão coerentes. O Pandoc usa os seus próprios temas. Compare a mesma amostra, sem assumir que os temas são transferidos sem alterações. Consulte o guia de realce.
Qual faz conversão em lote?
Para vários ficheiros, abra a exportação em lote: esta ferramenta paga aceita até 15 Markdown por execução e descarrega um ZIP com uma saída por entrada. O Creator inclui 20 execuções por mês. A opção PDF gera documentos separados; para um documento combinado, use Pandoc.
Por que md-to-pdf e não markdown-pdf?
Este guia usa o md-to-pdf indicado acima. Os nomes não são intercambiáveis; verifique documentação, versões e avisos de qualquer alternativa.
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?
Compare o custo total: plano no navegador, créditos da API se os usar, computação CI, fontes e manutenção dos modelos. O Creator para navegador não inclui créditos de renderização da API. Decida com base na utilização real.
Escolha pela entrega: documento individual no navegador, ZIP de lotes, compilações CI ou um documento com bibliografia em Pandoc. Teste a mesma amostra e examine os PDF reais.
# Document export test
## Handoff checklist
- [x] Headings
- [x] Table layout
- [x] Code formatting
| Check | Expected result |
|:--|:--|
| Body text | Readable at page width |
| Links | Retained in PDF |
> Demo content for comparing export methods.
Use esta amostra nos métodos que estiver a avaliar. A saída apresentada é um exemplo do produto, não uma comparação medida das cinco ferramentas. Verifique contornos, tarefas e seleção de texto em cada PDF.
Os limites e comandos acima foram verificados nestas fontes primárias atuais:
Abra MarkdownToImage, renderize Markdown e escolha o formato adequado. Antes de automatizar um lote, teste um documento representativo.