O Markdown permite que desenvolvedores, escritores e aplicativos de anotações mantenham o texto legível como texto simples e, ao mesmo tempo, marquem títulos, listas e ênfases. A maioria dos leitores, porém, não consegue abri-lo formatado. Markdown para PDF converte o arquivo com o Pandoc e o apresenta como um documento estilizado, para que um README, uma ata de reunião ou uma documentação vire um PDF que qualquer pessoa lê.
Como usar: Markdown para PDF
- Adicione o arquivo .md ou .markdown.
- Clique em Converter para PDF.
- Baixe o PDF.
- Confira tabelas, blocos de código e links no resultado.
O que recebe formatação
O Pandoc entende a sintaxe comum do Markdown: títulos, parágrafos, negrito e itálico, listas numeradas e com marcadores, citações, links, linhas horizontais, blocos de código delimitados e tabelas com barras verticais. Ele converte tudo em HTML, que depois é diagramado em páginas PDF, e os links continuam clicáveis no PDF. Notação matemática escrita em TeX não é composta como equação, então documentos que dependem muito de matemática precisam de uma ferramenta de composição própria.
Imagens e servidores sem Pandoc
A ferramenta converte um único arquivo Markdown, então imagens referenciadas por caminhos relativos não ficam disponíveis, e imagens de endereços da web são bloqueadas por segurança. Se precisar dos diagramas, converta-os separadamente com o Imagens para PDF. A formatação depende de o Pandoc estar instalado no servidor; quando não está, o VelloDoc ainda gera um PDF, mas mostra o Markdown como texto simples, com os símbolos visíveis.
Fluxos de documentação
Markdown para PDF é ótimo para compartilhar documentação com pessoas de fora de um repositório de código, como clientes, auditores ou gestores. Junte vários arquivos convertidos em um manual com o Juntar PDF e numere as páginas com o Numerar páginas. Para anotações simples, sem estrutura, o TXT para PDF basta, e o PDF para Markdown tira o texto de volta. O guia de formatos explica os prós e contras.
Quando usar: Markdown para PDF
READMEs para quem não é desenvolvedor
Entregue a clientes ou gestores um PDF legível do README de um projeto, sem pedir que naveguem por um repositório.
Atas de reunião e diários
Transforme anotações feitas em aplicativos de Markdown em documentos que você pode arquivar, imprimir ou enviar como ata.
Documentação técnica
Empacote guias de instalação e procedimentos operacionais como PDFs para auditorias, passagens de bastão ou consulta offline.
Limitações importantes
Markdown para PDF converte um arquivo por vez, então imagens relativas não são incluídas e imagens remotas são bloqueadas. Fórmulas em TeX não são compostas. A formatação completa exige o Pandoc no servidor; sem ele, o resultado é texto simples. O WeasyPrint também é necessário.
Markdown para PDF: perguntas frequentes
Qual sintaxe de Markdown é aceita?
Títulos, ênfases, listas, citações, links, blocos de código delimitados, linhas horizontais e tabelas com barras verticais são todos aceitos pelo Pandoc.
Por que minhas imagens sumiram?
Só o arquivo Markdown é enviado, então imagens referenciadas por caminhos relativos não são encontradas, e imagens remotas são bloqueadas. Converta as imagens separadamente e junte os PDFs se precisar.
Por que meu PDF mostra os símbolos do Markdown crus?
O servidor não tem o Pandoc instalado, então o arquivo foi renderizado como texto simples. Um servidor com Pandoc gera um resultado formatado.
O código tem realce de sintaxe?
Os blocos de código mantêm o layout monoespaçado e as quebras de linha. O realce colorido depende da versão do Pandoc no servidor, então não conte com ele para entender o código.