Converter Markdown em PDF: como transformar .md em PDF

Converta um arquivo Markdown (.md) em PDF com Pandoc, VS Code, Typora, Obsidian ou iPhone, mantendo tabelas e código, e resolva o erro do pdflatex.

Para converter Markdown em PDF, abra o arquivo .md em um editor que exporta PDF (Typora: Arquivo > Exportar > PDF; Obsidian no computador: Exportar para PDF na paleta de comandos; VS Code com a extensão Markdown PDF) ou rode o Pandoc: pandoc notes.md -o notes.pdf --pdf-engine=weasyprint. Sem a opção --pdf-engine, o Pandoc exige o LaTeX instalado. No iPhone e no iPad, use um app de Markdown que imprime ou exporta PDF, ou um conversor que roda no aparelho.

Atualizado em 7 de novembro de 2026. Os passos de cada ferramenta foram lidos nas páginas do Pandoc, do Typora, do Obsidian e da extensão do VS Code em 7 de novembro de 2026. O teste abaixo foi feito nesse dia com Pandoc 3.8.3, WeasyPrint 68.1 e Chrome 156 no macOS 15.6.

Por que o Markdown precisa de um conversor

Um arquivo .md é texto simples com marcas de formatação: # para títulos, ** para negrito, barras verticais para tabelas. Um PDF é uma página diagramada. Algo precisa renderizar o Markdown (definir fontes, tamanhos e espaçamento) e depois imprimi-lo em páginas. Todos os métodos abaixo fazem essas duas etapas; a diferença está no controle que você tem sobre a aparência.

O Markdown também vem em variações. Tabelas, listas de tarefas e notas de rodapé são extensões (GitHub Flavored Markdown e outras). Quase todas as ferramentas aceitam esses recursos, mas teste uma amostra antes se o seu arquivo os usar.

Método 1: Pandoc (Mac, Windows, Linux)

O Pandoc é um conversor gratuito de linha de comando. Instale-o com o Homebrew no Mac (brew install pandoc) ou pelo instalador em pandoc.org.

O comando

pandoc notes.md -o notes.pdf

O manual do Pandoc diz que, por padrão, ele cria PDFs por meio do LaTeX, o que exige um motor LaTeX instalado. Em um Mac sem LaTeX, você recebe o erro pdflatex not found. Please select a different --pdf-engine or install pdflatex.

Duas formas de contornar a exigência do LaTeX

  • Use um motor HTML: pandoc notes.md -o notes.pdf --pdf-engine=weasyprint (instale com brew install weasyprint). Estilize com um arquivo CSS: --css=style.css.
  • Instale o LaTeX (MacTeX, ou uma distribuição pequena como o TinyTeX) e mantenha o padrão. O LaTeX dá uma composição com qualidade de livro e fórmulas matemáticas, ao custo de uma instalação grande.

O manual do Pandoc também lista xelatex, lualatex, tectonic, typst, wkhtmltopdf, prince e pagedjs-cli como motores.

O teste

Em 7 de novembro de 2026, um arquivo Markdown (título, texto em negrito, um link, uma tabela, um bloco de código e uma lista) foi convertido de três formas, e cada PDF foi conferido com pdftotext e PyMuPDF.

CaminhoResultadoTabelaLink clicávelTamanho do arquivo
pandoc --pdf-engine=weasyprintPDF de 1 páginaMantidaSim15,3 KB
pandoc -s para HTML e depois impressão em PDF pelo Chrome sem interfacePDF de 1 páginaMantidaSim41,7 KB
pandoc notes.md -o notes.pdf (padrão)Erro: pdflatex not foundNenhum PDF

Os dois caminhos que funcionaram mantiveram o texto selecionável. O WeasyPrint gerou o arquivo menor; o Chrome incorporou mais dados de fonte.

Método 2: VS Code com a extensão Markdown PDF

  1. No VS Code, instale a extensão Markdown PDF (de yzane).
  2. Abra o arquivo .md.
  3. Pressione F1 (ou Command+Shift+P / Ctrl+Shift+P) e execute Markdown PDF: Export (pdf). A mesma opção está no menu de clique com o botão direito do editor.
  4. Procure o PDF na mesma pasta do arquivo .md.

A extensão renderiza com o Chromium; o README dela diz que um Chromium gerenciado é baixado automaticamente no primeiro uso. Usuários relataram falhas de exportação no macOS quando esse download é bloqueado, então permita-o ou aponte a extensão para um Chrome já instalado.

Método 3: Typora

  1. Abra o arquivo .md no Typora.
  2. Escolha Arquivo > Exportar > PDF.
  3. Escolha o local e salve.

A documentação do Typora diz que a exportação para PDF e HTML não precisa do Pandoc. O tamanho do papel, as margens e o tema usado no PDF são definidos em Preferências > Exportar > PDF.

Método 4: Obsidian (computador)

  1. Abra a nota.
  2. Abra a paleta de comandos e escolha Exportar para PDF.
  3. Escolha as opções de exportação e um local, depois salve.

A ajuda do Obsidian diz que exportar para PDF não está disponível no app Obsidian para celular. Plugins da comunidade acrescentam mais estilos de exportação, e alguns enviam a sua nota a um serviço externo, então leia a descrição do plugin antes de instalar.

Método 5: imprimir pelo navegador

Se o Markdown já aparece renderizado em uma página da web (um README no GitHub ou no GitLab, uma documentação, um app de notas na web), imprima essa página: Command+P ou Ctrl+P e depois Salvar como PDF. No Mac, Arquivo > Imprimir > menu PDF > Salvar como PDF funciona em qualquer app que renderize o Markdown. Veja converter HTML em PDF para dicas de impressão.

Como converter Markdown em PDF no iPhone e no iPad

O iOS mostra arquivos .md como texto simples no app Arquivos, com as marcas visíveis. Para obter um PDF formatado:

  • Um app editor de Markdown com visualização: abra o arquivo, mude para a visualização renderizada e use a opção de exportar ou imprimir do app. Na visualização de impressão, afastar dois dedos sobre a página a abre como um PDF que você pode salvar no Arquivos (um atalho comum, que não consta no guia da Apple).
  • O Obsidian no iPhone não exporta PDF, segundo a página de ajuda dele; use o caminho da impressão a partir de uma visualização renderizada, se houver, ou exporte no computador.
  • Um conversor no aparelho que abre arquivos .md diretamente; o PDF Opus é a escolha principal (seção abaixo).

Mais noções básicas de PDF no iPhone estão em como criar PDF no iPhone. Para arquivos .txt simples, veja converter TXT em PDF e, para todos os outros formatos, o guia do conversor de PDF.

Limites dos métodos comuns

  • O Pandoc exige um terminal e, por padrão, o LaTeX.
  • As exportações dos editores seguem o tema do editor; mudar fontes ou margens significa editar CSS ou preferências.
  • A exportação de PDF do Obsidian existe só no computador.
  • No iPhone, o caminho da impressão dá pouco controle sobre o tamanho da página e as margens.

Conversores de Markdown em PDF online

Conversores na web deixam você colar o Markdown ou enviar um arquivo .md e baixar um PDF. São rápidos para uma tarefa avulsa, mas o seu texto vai para o servidor de outra pessoa. Notas, documentos internos e rascunhos costumam conter nomes, chaves ou planos, então prefira um método local para qualquer coisa privada. Veja editores de PDF online são seguros?.

Os métodos comparados

MétodoAparelhosPreparaçãoControle de estiloEm loteO arquivo sai do aparelho
PDF Opus (escolha principal)iPhone, iPad, MacAbrir o arquivo .mdLayout padrão limpoPor arquivoNão
Pandoc + WeasyPrint ou LaTeXMac, Windows, LinuxTerminal e instalaçõesTotal (CSS ou modelos LaTeX)Sim, com scriptNão
VS Code Markdown PDFMac, Windows, LinuxExtensão + ChromiumCSSNãoNão
TyporaMac, Windows, LinuxAppTemas e margensNãoNão
ObsidianSó no computadorAppTamanho da página, margens, pluginsNãoNão
Conversores onlineQualquer navegadorNenhumaPoucoAlgunsSim

Dicas para um PDF melhor a partir do Markdown

  • Adicione um título com front matter YAML (title: Report) para o Pandoc colocá-lo na primeira página e nos metadados do PDF.
  • Force quebras de página com CSS de impressão (h1 { break-before: page; }) no WeasyPrint ou em temas do VS Code e do Typora.
  • Mantenha o código legível: linhas longas em blocos de código são cortadas. Quebre-as na origem, ou defina pre { white-space: pre-wrap; }.
  • Prefira caminhos relativos nas imagens e rode o conversor a partir da pasta do arquivo, para que as imagens sejam encontradas.
  • Adicione um sumário no Pandoc com --toc.
  • Confira as fórmulas: motores LaTeX renderizam fórmulas $...$; motores HTML precisam de MathJax ou KaTeX na etapa do HTML.

Solução de problemas

“pdflatex not found”

O caminho padrão do Pandoc para PDF exige o LaTeX. Adicione --pdf-engine=weasyprint ou instale uma distribuição LaTeX.

As tabelas saem como texto simples com barras verticais

O renderizador não suporta tabelas em Markdown, ou falta à tabela a linha separadora do cabeçalho (|---|---|). Adicione o separador, ou use o Pandoc ou outra ferramenta com suporte a tabelas.

As imagens não aparecem

Os caminhos das imagens são relativos a outra pasta. Rode o conversor a partir da pasta do arquivo Markdown, ou use caminhos completos.

Caracteres especiais aparecem como quadrados

A fonte escolhida não tem esses caracteres. Com Pandoc e LaTeX, use --pdf-engine=xelatex e uma fonte que os cubra; com motores HTML, defina em CSS uma fonte que os cubra.

A exportação do VS Code não faz nada no Mac

A extensão não conseguiu baixar ou iniciar o Chromium. Confira o painel de saída da extensão, permita o download, ou defina nas configurações dela o caminho de um Chrome instalado.

PDF Opus: o melhor app para converter Markdown em PDF (escolha principal)

O melhor app para converter Markdown em PDF é o PDF Opus. Ele abre arquivos .md no seu iPhone, iPad e Mac e os converte em PDF no aparelho, além de HTML, Word, Excel, PowerPoint, CSV, texto simples e imagens. Escritas da direita para a esquerda não são moldadas e fluxos de várias colunas são compostos em uma só coluna, o que combina com notas típicas em Markdown. Depois de converter, adicione números de página, uma marca d’água ou uma assinatura, junte o PDF com outros arquivos e comprima-o no mesmo app. O PDF Opus roda em um motor de PDF próprio, escrito do zero. Seus documentos são processados no seu aparelho. O app só se conecta à internet para compras, verificações de licença (versão direta) e verificações de atualização (versão direta).

Perguntas frequentes

Como converter um arquivo .md em PDF?

Abra-o em um editor que exporta PDF (Typora, Obsidian no computador, VS Code com Markdown PDF) ou rode pandoc file.md -o file.pdf --pdf-engine=weasyprint.

Como converter Markdown em PDF no Mac?

Instale o Pandoc e o WeasyPrint com o Homebrew e rode o comando acima, ou use o Typora, o Obsidian ou o VS Code. Qualquer app que mostre o Markdown renderizado também imprime em PDF com Arquivo > Imprimir > menu PDF > Salvar como PDF.

Dá para converter Markdown em PDF sem instalar nada?

Dá, com um conversor online, se você aceitar enviar o texto. Um README renderizado no GitHub também pode ser impresso em PDF pelo navegador.

O Obsidian exporta PDF no iPhone?

Não. A ajuda do Obsidian diz que a exportação de PDF não está disponível no app para celular.

Por que o Pandoc diz pdflatex not found?

O Pandoc usa o LaTeX para PDF por padrão. Escolha outro motor com --pdf-engine=weasyprint ou instale o LaTeX.

Como manter blocos de código e tabelas no PDF?

Use um conversor com suporte a GitHub Flavored Markdown ou o Pandoc. No teste, o Pandoc com WeasyPrint e o caminho pelo Chrome mantiveram a tabela e o bloco de código.

Como estilizar um PDF de Markdown?

Passe um arquivo CSS ao Pandoc com WeasyPrint (--css=style.css), escolha um tema no Typora ou edite a configuração de estilos da extensão do VS Code.

Dá para converter vários arquivos Markdown em PDF de uma vez?

Dá, com um laço do Pandoc no terminal, por exemplo for f in *.md; do pandoc "$f" -o "${f%.md}.pdf" --pdf-engine=weasyprint; done.