Markdown para PDF: o caminho rápido (e os outros)
Se você só precisa de um PDF e seguir em frente, abra /markdown-to-pdf, cole seu Markdown e clique em PDF. A saída preserva títulos, realce de código, tabelas, fórmulas e diagramas Mermaid. Não precisa instalar nada, configurar template ou usar linha de comando — funciona em qualquer navegador.
Esse é o caminho mais rápido. O restante deste guia explica por que o passo Markdown → PDF importa, o que esperar do export e onde encaixam as outras quatro opções comuns (Pandoc, plugins do VSCode, impressão do navegador, CLI).
Markdown é ótimo para autores e revisores — amigável ao Git, sintaxe leve, fácil de diferenciar. Mas quando o documento sai do círculo de engenharia, a audiência muda:
- Stakeholders querem layout estável. Um Markdown renderizado no VS Code não se parece com o mesmo arquivo colado no Notion ou em um chat. PDF congela o layout, então números de página em uma aprovação não variam entre máquinas.
- Compliance e compras querem carimbo de data. Muitos fluxos de auditoria exigem um PDF datado. Tendo um, você anexa em ticket, compra ou dossiê sem precisar explicar.
- Existem revisores em papel e offline. Surpreendentemente muitos clientes, advogados e operadores anotam em papel. PDF é a língua franca disso.
- Compartilhamento móvel. PDFs abrem nativamente em iOS e Android, sem plugin de Markdown.
Se você entrega notas de release, um SLA, resposta a RFP ou relatório para cliente, a entrega geralmente é o PDF — não o Markdown fonte.
Nosso conversor de Markdown para PDF usa um motor Chromium real em modo headless, então a pré-visualização é exatamente o que sai no arquivo:
- Cole ou solte um arquivo
.md. Suporta arrastar e soltar; limite de 1 MB por arquivo. - Ajuste tema, fonte e largura no painel direito. Temas claro e escuro exportam. Para impressão, escolha largura próxima a A4.
- Clique em PDF. O arquivo é baixado. A saída gratuita leva marca d’água; usuários gratuitos autenticados têm atualmente cinco exportações sem marca no total.
O que é preservado automaticamente:
- Títulos, listas, tabelas, citações, links
- Blocos de código cercados com realce de sintaxe para qualquer linguagem comum
códigoinline e código indentado- Imagens embutidas (data URI e URL remoto)
- Fórmulas KaTeX:
$$\int_0^1 x^2\,dx$$renderiza como equação tipográfica - Diagramas Mermaid: blocos
```mermaidblocks render as SVG inside the PDF - Task lists (
- [x]/- [ ])
| Method | Best fit | Main tradeoff |
|---|---|---|
/markdown-to-pdf | One-off documents with code, math, and diagrams | 1 MB input; free output rules apply |
| Pandoc | Citations, books, controlled templates | Requires a PDF engine and template work |
| VS Code Markdown PDF | Exporting from the editor | Rendering depends on extension settings |
| Browser print | A page already rendered correctly | Print CSS and page breaks vary |
md-to-pdf | Scripts and CI | Requires Node.js and a browser runtime |
Use the five-method comparison when you need a deeper tool choice. Avoid deciding from claimed install sizes or stopwatch figures: both change with platform, cache, and release.
- Keep tables narrow enough for the chosen paper size.
- Use high-resolution raster images or SVG for printed output.
- Replace fragile relative image paths or configure the renderer's resource path.
- Test one KaTeX block and one Mermaid diagram before exporting a long document.
- Inspect the downloaded PDF for page breaks, clipped code, missing fonts, and link targets.
For syntax colors, use the current option for each tool. Pandoc documents --syntax-highlighting; VS Code Markdown PDF uses markdown-pdf.highlightStyle; md-to-pdf uses --highlight-style. See the code-highlighting guide.
The current hosted converter accepts up to 1 MB of Markdown input and renders PDF with server-side Chromium. It supports code highlighting, KaTeX, Mermaid, tables, images, and task lists. Free PDF output includes a watermark; signed-in free users currently receive five watermark-free exports in total.
Server-side rendering means sensitive files leave the local browser for processing. Review the live privacy and retention terms before submitting confidential material.
Can I use it without installing software? Yes. The hosted path only needs a browser.
Can I combine several Markdown files? The web flow is single-file. For repeatable N-to-N or N-to-one jobs, use the batch conversion guide.
Will code, math, and Mermaid survive? They are supported, but always test your exact theme, fonts, remote images, and diagram syntax.
Use the web converter for an occasional document, Pandoc for citation-heavy publishing, VS Code for editor-centric export, and md-to-pdf for automation. The best method is the one you can reproduce and verify, not the one with the most aggressive speed claim.
Use this small fixture before exporting a long document:
# Export check
- [x] Task list
- [ ] Second item
| Feature | Status |
|---|---|
| Code | Ready |
| Math | Test |
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.