Ú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-depthdefine 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,1ou2costuma ficar mais limpo.--epub-cover-image=cover.jpgfaz o mesmo que o campocover-image. O Pandoc recomenda uma capa com menos de 1000px de largura e de altura.--epub-title-page=falseremove 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 Markdown | O que acontece no EPUB (padrões do Pandoc) |
|---|---|
# Chapter | Começa um novo arquivo de capítulo e aparece no sumário |
## Section | Aparece no sumário (profundidade 3 por padrão), mas fica dentro do arquivo do capítulo |
### Subsection | Aparece no sumário só se a profundidade permitir |
| Texto em negrito com cara de título | Nã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=2ou3. - 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:
| Pandoc | Conversor no navegador | |
|---|---|---|
| Precisa instalar | Sim | Não |
| Repetível em um script de build ou em CI | Sim | Não |
| CSS, fontes e filtros personalizados | Controle total | Limitado às configurações da ferramenta |
| Junção de vários arquivos | Sim, listando-os | Junte tudo em um arquivo antes |
| Ideal para | Livros que você gera de novo com frequência | Conversõ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 →