Markdown para PDF
Converta arquivos Markdown (.md, .markdown) — READMEs, docs, posts de blog, escrita técnica — em um documento PDF estilizado com títulos, blocos de código, tabelas e links renderizados. Os arquivos são processados no seu navegador.
Markdown para PDF converte arquivos .md e .markdown em um documento PDF estilizado. O Markdown é analisado pelo marked (um parser compatível com CommonMark/GFM), renderizado como HTML estilizado dentro do seu navegador, capturado pelo html2canvas e embutido em um PDF usando pdf-lib. Escolha um tema (Claro, Sépia, Otimizado para impressão), fonte, tamanho de página e margem. Títulos, blocos de código, tabelas, listas e links todos renderizam corretamente.
O que é Markdown para PDF?
Markdown é a linguagem de marcação leve criada por John Gruber em <strong>2004</strong> e padronizada como <a href="https://commonmark.org/" target="_blank" rel="noopener">CommonMark</a> em 2014. Usa pontuação simples — sustenidos para títulos, asteriscos para ênfase, crases para código — para produzir documentos estruturados que se leem naturalmente como texto puro. GitHub, GitLab, Reddit, Discord, Notion, Obsidian e a maioria dos geradores de sites estáticos usam Markdown como seu formato primário de conteúdo. Arquivos README, documentação de API, escrita técnica e posts de blog são em sua esmagadora maioria Markdown.
Converter Markdown para PDF é comum quando você precisa compartilhar um documento Markdown com alguém que não vai abri-lo em um visualizador de Markdown — pense em clientes, executivos, alunos, qualquer pessoa fora do mundo de ferramentas de desenvolvedor. PDF é o formato universal de compartilhamento. A maioria das ferramentas online de Markdown para PDF envia seu arquivo para um servidor remoto, o que é desconfortável para specs de produtos não lançados, documentação interna ou qualquer coisa que você não queira que fique no disco de outra pessoa. Esta ferramenta executa toda a conversão no seu navegador.
Como funciona a conversão Markdown no navegador?
O Pikowl lê cada arquivo Markdown via API Blob.text(), analisa-o com o marked (CommonMark + extensões GitHub Flavored Markdown incluindo tabelas, listas de tarefas, tachado), e renderiza o HTML resultante dentro de um contêiner estilizado oculto na página. O html2canvas captura a saída renderizada como uma imagem 2× DPI, que é fatiada em pedaços do tamanho de página e embutida como páginas PDF usando pdf-lib. O tema escolhido define o CSS aplicado ao contêiner — Claro (fundo branco padrão, texto escuro), Sépia (papel creme quente para leitura com baixo cansaço visual) ou Otimizado para impressão (alto contraste preto sobre branco, otimizado para impressão). Nada é enviado para nenhum servidor.
É seguro converter documentos Markdown sensíveis aqui?
Sim. Abra a aba de rede no DevTools enquanto usa a ferramenta — você verá os chunks marked e html2canvas baixados uma vez no primeiro uso, e zero requisições de saída depois disso. Os arquivos Markdown são lidos localmente via File API, analisados dentro do navegador, e o PDF resultante existe apenas na memória do seu navegador até você baixá-lo. Documentação interna, specs técnicas não lançadas e notas confidenciais nunca cruzam a rede.
Quais recursos do Markdown são suportados?
O marked suporta a especificação CommonMark completa mais a maioria das extensões GitHub Flavored Markdown (GFM): tabelas, listas de tarefas, tachado, autolinking e blocos de código cercados com tags de linguagem. HTML inline dentro de Markdown é renderizado. Não suportado: syntax highlighting dentro de blocos de código (renderizados como monospace simples), diagramas Mermaid, matemática (LaTeX/KaTeX), definições de notas de rodapé, sintaxe de diretivas customizadas. A saída é unicode-completa via a stack de fontes do navegador — chinês, japonês, coreano, cirílico, árabe e emoji todos renderizam corretamente.
Quais são os limites e por quê?
Até 50 arquivos Markdown por conversão, 10 MB por arquivo, com aviso suave em 100 MB combinados e teto rígido em 150 MB. Um arquivo Markdown de 10 MB é excepcional — a maioria dos arquivos README e documentação está bem abaixo de 100 KB. O passo de rasterização do html2canvas pode levar vários segundos por página em documentos longos; se seu PDF exceder ~50 páginas, espere uma espera perceptível.
Como o Pikowl se compara ao Smallpdf e iLovePDF para Markdown?
Smallpdf e iLovePDF não oferecem ferramentas dedicadas de Markdown para PDF — ambos rodam Markdown por pipelines genéricos de texto-para-PDF que removem a formatação. As diferenças substanciais são fidelidade de formatação, local de processamento e preço. Os números abaixo refletem as ofertas do nível gratuito de cada serviço em abril de 2026.
| Recurso | Pikowl | Smallpdf | iLovePDF |
|---|---|---|---|
| Onde os arquivos são processados | Seu navegador | Servidor remoto | Servidor remoto |
| Cadastro necessário | Não | Opcional | Opcional |
| Opções de saída | Temas · 3 fontes · 3 tamanhos de página | Sem renderização Markdown | Sem renderização Markdown |
| Tamanho máx. (grátis) | 10 MB | 5 MB | 200 MB (combinado) |
| Preço | Grátis | $9/mês para ilimitado | $7/mês para premium |
Fontes: smallpdf.com/pricing e ilovepdf.com/pricing, consultadas em abril de 2026.
Usos comuns
- README como entregável para cliente: Converta o README do GitHub de um projeto em um PDF que você pode anexar a um e-mail de status para cliente ou follow-up de venda — sem compartilhar o link do GitHub.
- Documentação técnica: Exporte uma referência de API ou capítulo de runbook como um PDF estilizado para inclusão em um pacote de fornecedor ou auditoria de conformidade.
- Exportação Notion / Obsidian: Muitos apps de notas exportam notas como Markdown — converta-os em um único PDF para arquivamento ou distribuição imprimível.
- Arquivamento de posts de blog: Converta um post de blog de site estático (Hugo, Jekyll, Eleventy) em um PDF imprimível para leitura offline ou redistribuição.
- Materiais de curso: Combine uma série de notas de aula em Markdown em um PDF paginado para folhetos de alunos.
- Templates de pull request e changelogs: Converta CHANGELOG.md ou RELEASE-NOTES.md em um PDF pronto para release para distribuição.
FAQ
Recursos do GitHub Flavored Markdown são suportados?
A maioria deles: tabelas, listas de tarefas (sintaxe de checkbox - [ ]), tachado (~~texto~~), autolinking, blocos de código cercados. Não suportado: syntax highlighting dentro de blocos de código (renderizados como monospace simples), diagramas Mermaid, definições de notas de rodapé, matemática (LaTeX/KaTeX) e atributos de alinhamento de imagem específicos do GitHub. Para a maioria dos casos de uso de README e docs isso é suficiente.
Tabelas Markdown renderizarão corretamente no PDF?
Sim. A sintaxe de tabela GFM (colunas separadas por pipe com uma linha de cabeçalho) renderiza como uma tabela HTML estilizada com bordas, fundo de cabeçalho e alinhamento adequado no PDF de saída.
Posso obter blocos de código com syntax highlighting?
Não nesta versão. Blocos de código renderizam com fonte monoespaçada e um sutil tom de fundo, mas sem syntax highlighting por linguagem (integração Prism ou Highlight.js). Se você precisa de código destacado, uma abordagem intermediária é copiar a versão destacada do seu editor como HTML e usar a ferramenta HTML para PDF.
Qual é a diferença entre os temas Claro, Sépia e Otimizado para impressão?
Claro é o padrão — fundo branco com texto cinza escuro, sans-serif moderno. Sépia usa um fundo creme quente com texto cinza-marrom, mais fácil aos olhos para sessões de leitura longas. Otimizado para impressão é preto puro sobre branco com alto contraste, otimizado para saída em papel e economia de toner.
Caracteres não-Latin (chinês, japonês, cirílico) renderizam corretamente?
Sim — diferente do TXT para PDF (que é limitado pelas fontes WinAnsi do pdf-lib), o Markdown para PDF usa html2canvas que renderiza via a stack de fontes completa do navegador. CJK, cirílico, devanágari, árabe e emoji todos renderizam corretamente usando as fontes do sistema disponíveis no seu navegador.
O texto no PDF resultante é selecionável?
Não — o pipeline html2canvas rasteriza o HTML renderizado, então as páginas PDF resultantes são imagens, não texto selecionável. Esta é a contrapartida pela fidelidade total de estilo. Para texto selecionável, salve seu Markdown como TXT puro e use TXT para PDF — você perderá o estilo mas ganhará busca com Cmd+F.
Os arquivos Markdown são enviados para um servidor?
Não. A conversão roda inteiramente no seu navegador — abra a aba de rede do DevTools e você verá as bibliotecas marked e html2canvas baixadas uma vez no primeiro uso, e zero requisições de saída depois disso. O conteúdo Markdown é lido do seu disco via File API, analisado no navegador, renderizado em canvas e embutido em um PDF usando pdf-lib.
Em números
- Markdown foi criado por John Gruber em 2004 como uma forma de escrever conteúdo web em texto puro; CommonMark formalizou a especificação em 2014, e GitHub Flavored Markdown a estende com tabelas e listas de tarefas.
- marked, o parser que esta ferramenta usa, processa Markdown a vários milhares de linhas por milissegundo em navegadores modernos — o passo de análise é essencialmente instantâneo; a rasterização do html2canvas é a fase consumidora de tempo.
- Markdown é o formato de conteúdo padrão para READMEs do GitHub, wikis do GitLab, páginas Notion, notas Obsidian, sites estáticos Hugo / Jekyll / Eleventy e mensagens do Discord — tornando-o, sem dúvida, o formato de documento estruturado mais escrito na web moderna.