Converta Markdown em PDF

Passo a passo: Markdown para PDF

1. Abra o seu arquivo .mdSelecione um arquivo Markdown ou arraste-o para a ferramenta. Exportações de apps de notas, wikis e repositórios de código funcionam, desde que usem a sintaxe Markdown padrão.
2. Defina o papel e o tamanho base da fonteEm “Tamanho da página”, escolha A4 ou “Carta (216 × 279 mm)” e, em “Tamanho da fonte”, o tamanho base do corpo do texto. Um tamanho menor faz caber na largura da página uma parte maior de uma tabela larga ou de uma linha de código comprida.
3. Gere e baixeClique em “Criar PDF” e salve o arquivo. Abra uma vez para conferir títulos, tabelas e eventuais marcadores de imagem antes de mandar adiante.

Um exemplo na prática

O README.md de um projeto tem um título, duas seções, uma lista numerada de instalação, um bloco de código de shell e uma tabela de três colunas. Com A4 e o tamanho base padrão de 11 pt, o título (#) sai em 22 pt (11 × 2), os títulos de seção (##) em 17,6 pt (11 × 1,6), o bloco de código em Courier de 9,68 pt (11 × 0,88) sobre uma faixa sombreada, e o texto da tabela em 10,12 pt (11 × 0,92).

A largura de texto de 171,9 mm (210 mm menos duas margens de 19,05 mm) é dividida igualmente, então cada uma das 3 colunas da tabela fica com cerca de 57,3 mm. O resultado é baixado como README.pdf.

O que a ferramenta faz e quais são os limites

• Imagens aparecem como marcadores [image: texto alternativo], porque os arquivos referenciados não são carregados.
• Só links http, https e mailto ficam clicáveis; links relativos aparecem como texto formatado.
• Notas de rodapé, fórmulas matemáticas e código de diagramas não são renderizados como tal.
• O estilo é fixo: sem temas nem CSS personalizado.
• Escritas da direita para a esquerda e escritas complexas, como árabe, hindi e tailandês, não são diagramadas corretamente.

Markdown para PDF: como funciona

Markdown é prático de escrever, mas quem não é desenvolvedor prefere receber um documento a um arquivo cheio de cerquilhas e asteriscos. Esta ferramenta interpreta o seu Markdown com o marked, uma biblioteca de código aberto com licença MIT, seguindo a especificação CommonMark e mais dois acréscimos do GitHub: tabelas e tachado. Depois, o documento interpretado é diagramado em páginas A4 ou Carta, em um estilo único e fácil de ler.

Elementos que saem formatados

• Títulos, parágrafos, negrito, itálico e tachado
• Código no meio da linha e blocos de código cercados, em fonte monoespaçada sobre fundo sombreado
• Listas com marcadores, numeradas e aninhadas
• Citações e linhas horizontais
• Tabelas, desenhadas como uma grade simples
• Links, que continuam clicáveis no PDF

A aparência é fixa: não há temas nem como aplicar o seu próprio CSS. As duas coisas que você controla são o tamanho do papel e o tamanho base da fonte. Isso deixa a ferramenta rápida de usar e o resultado consistente, o que combina mais com apostilas, documentação e relatórios do que com folhetos cheios de design.

Quando usar

• Um README para quem está fora do repositório

  Notas de configuração de um projeto escritas em Markdown podem ir para um cliente ou gestor como um PDF que abre em qualquer lugar, com os passos de instalação em listas numeradas e os comandos em blocos de código sombreados.

• Anotações de reunião que viram material impresso

  Anotações digitadas às pressas em Markdown, com um título por assunto, marcadores para as decisões e uma pequena tabela de responsáveis e prazos, viram uma página pronta para imprimir na próxima reunião.

• Trabalho da faculdade escrito em um editor de texto simples

  O portal do curso só aceita PDF, mas você escreve em Markdown. Converta a versão final e envie um documento em que títulos, citações e links das fontes mantêm a formatação.

Por que as imagens aparecem como marcadores

O Markdown aponta para imagens por um caminho ou endereço da web, por exemplo ![Mapa do site](imagens/mapa.png). Esta página não carrega arquivos de fora do site, então as imagens referenciadas não são buscadas. No lugar delas, o PDF mostra um marcador [image: texto alternativo], com a descrição que está entre os colchetes, para que o leitor saiba que ali havia uma figura. Por isso vale a pena escrever no seu Markdown textos alternativos que digam alguma coisa.

Quando as figuras importam, faça um PDF delas com o JPG para PDF ou o PNG para PDF e junte-o ao texto renderizado com o Juntar PDF.

Idiomas e as fontes por trás deles

O português, o inglês e os outros idiomas escritos no alfabeto latino usam Helvetica e Courier, fontes padrão que todo leitor de PDF já tem, então nada precisa ser embutido. Grego e cirílico saem em Roboto, chinês e japonês em Droid Sans Fallback (as duas com licença Apache-2.0) e coreano em Nanum Gothic (SIL Open Font License); cada fonte é embutida como subconjunto, só com os caracteres que o seu documento usa. A fonte de chinês e japonês é um download de cerca de 4 MB, e a de coreano, de cerca de 2 MB; o navegador só busca cada uma quando o Markdown realmente tem esses caracteres.

As linhas em coreano quebram entre as palavras, do jeito que o texto coreano costuma ser diagramado. Árabe, hebraico e outras escritas da direita para a esquerda, assim como escritas complexas como o hindi e o tailandês, não são diagramados corretamente. Para documentos nesses idiomas, um processador de texto ou um navegador que lide com eles é um caminho melhor até o PDF.

Qualidade e tamanho do resultado

Todo o texto do PDF é vetorial: nítido em qualquer zoom, pesquisável e copiável. Como nenhuma imagem é embutida e as fontes vão em subconjunto, um documento Markdown típico gera um arquivo leve, fácil de mandar por e-mail. Os links continuam funcionando nos leitores de PDF que têm suporte a eles. Para uma cópia impressa que precise de números de página, passe o resultado pelo Numerar páginas.

Sintaxe que não é renderizada

• Imagens, que viram marcadores, como explicado acima.
• Estilo próprio: CSS personalizado, temas, cores e escolha de fontes.
• Extensões fora do CommonMark, com exceção das tabelas e do tachado do GitHub. Notas de rodapé, fórmulas matemáticas e diagramas escritos como código não fazem parte desse conjunto, então espere ver o texto-fonte deles, e não um resultado renderizado.
• Arquivos de texto simples. Se o seu arquivo não é bem Markdown, o TXT para PDF mantém cada linha e cada espaço exatamente como foram digitados.

A interpretação e a diagramação rodam nesta aba do navegador; o Markdown e o PDF gerado ficam no seu aparelho. Veja como confirmar.