Convert2EPUB
Menu
← Blog

Como converter Markdown em EPUB: com o Pandoc ou com um conversor sem instalação

Última atualização: 11 de novembro de 2026

A forma mais rápida de converter Markdown em EPUB é o Pandoc: rode pandoc book.md -o book.epub e você terá um EPUB válido. Se não quiser instalar nada, envie o arquivo .md para um conversor web como o Convert2EPUB. Em qualquer caso, a qualidade do e-book depende principalmente de como você estrutura os títulos e os metadados antes de converter.

Do que você precisa para converter um arquivo Markdown em EPUB?

Você precisa de um arquivo Markdown com uma estrutura de títulos clara, um título e um autor, e uma ferramenta que gere EPUB. O Pandoc é a ferramenta de linha de comando padrão. Um conversor no navegador faz o mesmo trabalho sem instalação.

Antes de converter, verifique se a origem está pronta:

  • Um título # por capítulo. Por padrão, o Pandoc divide um EPUB em capítulos nos títulos de nível 1, segundo o Guia do Usuário do Pandoc. Se você escreve os capítulos como ##, mude isso ou defina o nível de divisão (veja mais abaixo).
  • Título e autor em um bloco de metadados no início do arquivo, e não apenas em um título dentro do texto.
  • Imagens com caminhos relativos que funcionem a partir de onde você roda o comando, além de texto alternativo.
  • Nada de HTML bruto do qual você não possa abrir mão. Tags simples costumam sobreviver, mas scripts, iframes e truques de CSS não têm lugar em um arquivo para e-reader.

Como converter Markdown em EPUB com o Pandoc?

Instale o Pandoc, coloque um bloco de metadados YAML no início do arquivo e rode um único comando. O Pandoc monta o sumário a partir dos seus títulos.

1. Adicione os metadados

O Pandoc lê os metadados do EPUB de um bloco YAML no arquivo Markdown, ou de um arquivo YAML separado, como descreve o manual do Pandoc. Um bloco mínimo:

---
          title: The Lighthouse Letters
          author: Dana Whitfield
          lang: en-GB
          date: 2026-11-11
          cover-image: cover.jpg
          ---

lang importa mais do que se imagina. Ele controla a hifenização e a leitura em voz alta em alguns leitores. A data fica a seu critério, então use a data de publicação que você quer exibir.

2. Rode o comando

pandoc book.md -o book.epub --toc --toc-depth=2
  • --toc-depth define quantos níveis de título aparecem no sumário. Segundo o manual do Pandoc, o padrão é 3, então os níveis 1, 2 e 3 são listados. Para um romance, 1 ou 2 costuma ficar mais limpo.
  • --epub-cover-image=cover.jpg faz o mesmo que o campo cover-image. O Pandoc recomenda uma capa com menos de 1000px de largura e de altura.
  • --epub-title-page=false remove a página de rosto gerada, se você já escreveu a sua.

3. Junte vários arquivos

Muitos autores mantêm um arquivo por capítulo. Passe-os na ordem e o Pandoc os junta:

pandoc 01-intro.md 02-first-night.md 03-storm.md -o book.epub

Comece os nomes dos arquivos com números para que a ordem do shell bata com a ordem de leitura. Coloque o bloco de metadados só no primeiro arquivo.

4. Dê um estilo, com moderação

O Pandoc aplica uma folha de estilos padrão. Para mudá-la, passe --css=epub.css. Mantenha o CSS mínimo: defina o recuo dos parágrafos e as margens dos títulos, e não mexa na família nem no tamanho da fonte. Os aplicativos e aparelhos de leitura deixam cada pessoa escolher os dois, e sobrescrevê-los tira esse controle.

Como estruturar os títulos para que os capítulos e o sumário saiam certos?

Use # para os capítulos e ## para as seções dentro deles, e não pule níveis. O menu de navegação do EPUB é gerado a partir desses títulos, então a estrutura que você escreve é a estrutura que o leitor recebe.

Seu MarkdownO que acontece no EPUB (padrões do Pandoc)
# ChapterComeça um novo arquivo de capítulo e aparece no sumário
## SectionAparece no sumário (profundidade 3 por padrão), mas fica dentro do arquivo do capítulo
### SubsectionAparece no sumário só se a profundidade permitir
Texto em negrito com cara de títuloNão é um título; não vai aparecer no sumário

Dois problemas comuns:

  • Um livro com um só título #. O livro inteiro vira um único arquivo grande. O manual do Pandoc observa que essa opção só afeta a composição interna do EPUB, não a forma como os capítulos aparecem para quem lê, e que alguns leitores podem ficar lentos com arquivos de capítulo muito grandes. Para um documento longo com poucos títulos de primeiro nível, use --split-level=2 ou 3.
  • O título do livro escrito como # e os capítulos também como #. O título passa a aparecer como um capítulo. Coloque o título no bloco YAML e reserve o # para os capítulos de verdade.

Se o sumário ainda parecer errado depois disso, nosso guia para corrigir um sumário de EPUB ausente ou quebrado passa pelas verificações.

Dá para converter Markdown em EPUB sem instalar o Pandoc?

Dá. Um conversor web que aceita arquivos .md deixa você enviar o arquivo, definir o título e o autor e baixar o EPUB. É bom para conversões avulsas e para quem não quer usar a linha de comando.

Veja como as duas abordagens se comparam:

PandocConversor no navegador
Precisa instalarSimNão
Repetível em um script de build ou em CISimNão
CSS, fontes e filtros personalizadosControle totalLimitado às configurações da ferramenta
Junção de vários arquivosSim, listando-osJunte tudo em um arquivo antes
Ideal paraLivros que você gera de novo com frequênciaConversões rápidas e ocasionais

A área de envio do Convert2EPUB lista o Markdown entre os formatos aceitos, com limite de 100 MB. Ela tem configurações de título, autor, fluido ou layout fixo e aparelho de destino. O modelo Standard grátis é descrito no site como bom para layouts simples, como romances, e é isso que a maioria dos manuscritos em Markdown também é. Se você não tem certeza se o fluido é a escolha certa, veja a nossa comparação entre EPUB fluido e de layout fixo. Para prosa, é.

O que conferir antes de enviar o EPUB para um e-reader?

Abra o arquivo em pelo menos um aplicativo de leitura de verdade e passe por uma lista curta. A maioria dos problemas de Markdown para EPUB aparece nos primeiros cinco minutos.

  • Sumário: abra o menu de navegação. Todos os capítulos devem estar lá, na ordem, com nomes que façam sentido.
  • Capa e título: a capa deve aparecer na visualização da biblioteca, e o título e o autor devem aparecer corretamente.
  • Imagens: confira se cada imagem aparece, se ajusta à tela e não tem bordas sobrando.
  • Blocos de código e tabelas: linhas longas em blocos de código podem sair da tela em leitores pequenos. Quebre-as ou encurte-as. Para uma tela de 6 polegadas, é melhor reescrever tabelas largas como listas.
  • Notas de rodapé: o Pandoc transforma as notas de rodapé do Markdown em notas com link. Toque em uma e confira se ela leva você de volta.
  • Validação: se você pretende publicar em uma loja, passe o arquivo pelo EPUBCheck, o validador apoiado pelo W3C que as lojas costumam usar. Ele pega problemas que os leitores deixam passar sem avisar.

Para telas e-ink pequenas, nosso artigo sobre configurações de EPUB para um leitor e-ink de 6 polegadas explica o que definir no arquivo e o que definir no aparelho.

Se preferir pular a configuração, você pode enviar o seu arquivo .md para o Convert2EPUB e baixar um EPUB fluido.

Posso ler no Kindle um EPUB feito a partir de Markdown?

Pode. Envie o EPUB para o seu Kindle por e-mail ou pelo aplicativo Send to Kindle, sem precisar convertê-lo para MOBI ou AZW3. A própria página do Convert2EPUB diz que o Send to Kindle aceita um EPUB como ele é. Nosso guia sobre como enviar um EPUB para o seu Kindle traz o passo a passo.

Perguntas frequentes

O Pandoc converte Markdown direto para MOBI ou AZW3?

Não. O Pandoc gera EPUB, não MOBI nem AZW3. Os fluxos atuais do Kindle aceitam EPUB diretamente, então uma conversão separada geralmente é desnecessária. Só Kindles muito antigos precisam de MOBI.

Por que o meu EPUB virou um único capítulo gigante?

Por padrão, o Pandoc divide os capítulos nos títulos de nível 1. Se o seu Markdown tem um só # ou nenhum, tudo vai parar em um único arquivo. Mude os títulos dos capítulos para # ou use --split-level=2.

Como adicionar uma imagem de capa?

Adicione cover-image: cover.jpg ao bloco YAML ou passe --epub-cover-image=cover.jpg. O manual do Pandoc recomenda uma imagem com menos de 1000px de largura e de altura. Mantenha o caminho relativo ao lugar de onde você roda o comando.

A formatação do Markdown, como negrito, listas e citações em bloco, é mantida?

Sim. Os elementos padrão do Markdown viram os equivalentes em HTML dentro do EPUB, e o estilo do próprio leitor os exibe. As extensões variam conforme a ferramenta, então confira no resultado as sintaxes menos comuns, como listas de definição ou listas de tarefas.

Posso converter uma pasta inteira de arquivos Markdown?

Com o Pandoc, pode. Liste os arquivos na ordem ou use um curinga como *.md, como faz um tutorial da DEV Community com um repositório de documentação. Numere os nomes dos arquivos para que a ordem seja previsível.

Pronto para converter o seu próprio PDF? É grátis para documentos de texto comuns, sem precisar de conta.

Converter um PDF em EPUB →