Converter Markdown para PDF

O conversor de Markdown para PDF do FileReshape formata no seu navegador um arquivo .md com títulos, listas, tabelas, blocos de código e listas de tarefas no estilo do GitHub, e você salva o resultado como PDF com texto selecionável pela janela de impressão do navegador. O arquivo não é enviado. Imagens que estão só vinculadas, e não incorporadas, aparecem como a sua descrição, e não há realce de sintaxe nem botão de download direto.

Um arquivo não foi convertido corretamente? Escreva para [email protected], de preferência com um pequeno arquivo de exemplo, e o problema será corrigido.

O essencial

Por que transformar Markdown em PDF

Markdown é a forma como desenvolvedores, escritores e aplicativos de anotações como Obsidian, Joplin e Typora guardam texto, legível como texto simples e formatado quando um aplicativo o exibe. Fora desses aplicativos, um arquivo .md é só um paredão de cerquilhas e asteriscos, que não é o que você quer mandar por e-mail a um cliente, entregar ou imprimir. Esta ferramenta lê o Markdown no seu navegador com o marked, um analisador de código aberto que segue as regras do GitHub Flavored Markdown, e o diagrama como um documento limpo, com títulos, texto em negrito e itálico, listas numeradas e com marcadores, listas de tarefas com caixas de seleção, tabelas com bordas, citações e blocos de código em fonte monoespaçada que quebram a linha em vez de passar da borda da página. Depois, o próprio mecanismo de impressão do navegador grava o PDF, então o texto continua nítido e pesquisável. O front matter YAML no início do arquivo, usado por blogs e geradores de sites estáticos, fica de fora do PDF.

Como converter Markdown para PDF

  1. Solte seu arquivo .md na caixa ou clique para escolhê-lo. Aparece uma prévia do documento formatado.
  2. Escolha o tamanho da página, as margens e o tamanho do texto.
  3. Clique em “Criar PDF”. Na janela de impressão do navegador, escolha “Salvar como PDF” como impressora ou destino e salve o arquivo.

O que saber sobre Markdown e PDF

Imagens que estão só vinculadas

O Markdown costuma apontar para imagens por endereço, como ![Logo](images/logo.png) ou um link da web. A ferramenta só tem o arquivo .md, não a pasta em volta dele, e não busca nada na web, então essas imagens aparecem como uma pequena caixa com a sua descrição. Imagens incorporadas no arquivo como data URLs são impressas. Para colocar imagens no PDF de outra forma, abra o Markdown em um editor que mostre as imagens e imprima a partir dele.

HTML dentro do Markdown

HTML simples, como <br>, <sup>, <details> ou uma tabela escrita em HTML, é mantido. Scripts, frames, formulários, estilos e vídeos incorporados são removidos, porque não fazem parte de um documento impresso e podem ser inseguros.

Sem realce de sintaxe

Os blocos de código são impressos em fonte monoespaçada com uma moldura clara, mas sem as cores que um editor usa para palavras-chave e strings. Linhas de código longas são quebradas para que nada seja cortado na borda da página.

Variantes de Markdown

Tabelas, listas de tarefas, texto tachado e links automáticos seguem as regras do GitHub, que a maioria dos aplicativos compartilha. Extensões que só alguns aplicativos têm, como notas de rodapé, fórmulas matemáticas, diagramas Mermaid, links wiki entre notas ou callouts do Obsidian, aparecem como texto simples.

Sobre os formatos

Markdown

Markdown é um formato de texto simples para escrever documentos formatados, criado por John Gruber em 2004. Cerquilhas criam títulos, asteriscos criam texto em negrito e itálico, e hifens criam listas. GitHub, GitLab, Reddit, Obsidian, exportações do Notion e muitas ferramentas de documentação o usam.

  • Um arquivo .md é texto simples, então abre em qualquer editor de texto e funciona bem com controle de versão, como o Git.
  • O GitHub Flavored Markdown (GFM) acrescenta tabelas, listas de tarefas, texto tachado e links automáticos às regras originais.
  • As imagens costumam ser vinculadas por endereço, então ficam em arquivos separados ao lado do arquivo .md ou na web.

PDF

O PDF (Portable Document Format) foi criado pela Adobe em 1993 e é uma norma ISO desde 2008. Um PDF aparece igual em qualquer dispositivo, por isso é usado para contratos, notas fiscais, formulários, manuais e documentos digitalizados.

  • Uma página pode conter texto, gráficos vetoriais e imagens, cada um posicionado com exatidão.
  • Documentos digitalizados costumam ter uma imagem por página.
  • Um PDF pode ser protegido por uma senha, necessária para abri-lo ou editá-lo.

Perguntas frequentes

Meu arquivo Markdown é enviado para algum lugar?

Não. O Markdown é lido e formatado pelo seu navegador no seu próprio dispositivo, e o PDF é gravado pela função de impressão do navegador. Nada é enviado a um servidor.

Como tiro a data e o endereço da web de cada página?

Desative “Cabeçalhos e rodapés” na janela de impressão do navegador, geralmente em Mais configurações. Isso também remove o título da página no topo.

Por que meus blocos de código não têm fundo cinza no PDF?

Os navegadores deixam de fora as cores de fundo ao imprimir, a menos que “Gráficos de fundo” esteja ativado na janela de impressão. A moldura em volta dos blocos de código é impressa de qualquer forma.

Posso converter um README do GitHub?

Sim. Baixe o arquivo README.md e solte-o aqui. Selos (badges) e capturas de tela vinculados da web aparecem como a sua descrição.