Jonathan Machado
O manuscrito está fechado. Você gera o EPUB para a loja, o PDF para a gráfica e o DOCX para o autor revisar. Três arquivos, tudo certo.
Aí o autor lê o DOCX e pede um ajuste na página 40. Agora você tem três documentos que discordam entre si, e a correção precisa ser refeita em cada um. Multiplique por seis rodadas de revisão, que é o normal em qualquer livro, e você entende por que produção editorial artesanal não escala: não é o trabalho de criar, é o trabalho de manter três cópias sincronizadas.
O jeito de sair disso não é trabalhar mais rápido. É parar de tratar formato como documento.
O que o Pandoc é
O Pandoc é um conversor universal de documentos, livre e de código aberto, criado por John MacFarlane. Ele lê dezenas de formatos de entrada e escreve em dezenas de formatos de saída: Markdown, EPUB, PDF, DOCX, HTML, ODT, LaTeX, Typst e por aí vai.
Dito assim parece só mais um conversor. A mudança real é de modelo mental: com o Pandoc, o texto vira a fonte e todos os formatos viram saída descartável. Você não mantém um EPUB, você gera o EPUB. Quando a correção chega, ela entra em um lugar só e os três arquivos são refeitos com um comando.
É a mesma lógica de versionar texto em vez de acumular proposta-final-v3: existe um original, e o resto é derivado.
Por que o EPUB é o caso em que ele mais brilha
O caminho mais curto é literalmente uma linha:
pandoc livro.md -o livro.epub
A partir daí, os recursos que resolvem um livro de verdade. Os metadados (título, autor, idioma, direitos) vêm de um bloco YAML no próprio arquivo ou de um arquivo separado com --metadata-file. A capa entra com --epub-cover-image. O visual sai de uma folha de estilo sua com --css. O sumário é gerado com --toc, e a profundidade dele se controla com --toc-depth. O ponto em que o livro se quebra em capítulos é definido por --split-level. Fontes podem ser embutidas com --epub-embed-font. E as imagens referenciadas no texto entram no pacote sozinhas, sem você montar nada.
A saída padrão é EPUB3; quando a loja ou o dispositivo exigir o formato antigo, -t epub2 resolve.
Repare no que não apareceu nessa lista: nenhuma etapa manual de arrastar caixa de texto.
A regra que muda a operação: uma fonte, muitos destinos
Com os capítulos em arquivos de texto separados, o mesmo material atende três públicos diferentes sem duplicação.
O DOCX vai para o autor revisar, porque autor revisa no Word e brigar com isso é perder tempo. O --reference-doc permite usar um documento seu como modelo de estilos, então a revisão chega formatada como a sua casa formata. O EPUB vai para a distribuição digital. O PDF vai para a impressão.
A correção do autor volta para os arquivos de origem, uma vez. Os três formatos são regerados. Ninguém precisa lembrar de replicar nada, que é exatamente onde o erro humano mora.
EPUB não é PDF, e confundir os dois estraga o livro
Este é o mal-entendido mais caro da produção digital, e ele aparece toda semana.
PDF é layout fixo: a página tem tamanho definido, a quebra de linha é decidida por você, e o leitor recebe exatamente aquilo. EPUB é texto fluido: o leitor escolhe o corpo da letra, a largura da tela e o tema, e o conteúdo se reacomoda. Não existe página no EPUB, existe posição relativa.
Por isso um PDF de livro impresso vira um péssimo ebook: no celular, ele exige zoom e arrasto lateral em cada parágrafo. E por isso um EPUB não substitui a diagramação de papel, tratada no artigo sobre quando o InDesign é obrigatório. São dois produtos, não dois formatos do mesmo produto.
Os erros que produzem um EPUB rejeitado
Lojas de ebook validam o arquivo antes de aceitar, e a recusa quase sempre vem de coisa banal.
Metadado faltando ou vazio. Título, autor e principalmente idioma. Idioma ausente ou errado quebra hifenização, leitura em voz alta e a própria validação.
Capa fora do padrão. Cada loja tem exigência de proporção e resolução mínima. Gerar sem conferir é garantir uma volta.
Imagem pesada demais. Foto de câmera direto no capítulo infla o arquivo e trava leitor antigo. Redimensione antes.
Sumário que não existe. Sem --toc, o leitor não consegue navegar, e isso costuma virar avaliação de uma estrela.
Nenhum desses aparece quando você abre o arquivo no seu computador. Todos aparecem no dispositivo do leitor ou na validação da loja, que é o pior lugar para descobrir.
Quando o Pandoc não é a ferramenta certa
Ele converte estrutura, não desenha página. Para livro impresso com diagramação de verdade (controle fino de entrelinha, viúvas e órfãs, capitulares, grade), o resultado padrão dele é funcional e sem personalidade. Aí o caminho é usar o Pandoc para chegar até um formato de diagramação e fazer o acabamento em uma ferramenta de página.
Ele também não é para livro ilustrado de layout fixo, onde texto e imagem precisam ficar exatamente onde foram colocados. E ele não escreve o livro por você: se o problema é que o conteúdo não existe, a ferramenta é outra, e está no artigo sobre por que quem sabe muito trava na hora de escrever.
Onde ele entra no stack da eBuz
O Pandoc é peça da fábrica de livros da eBuz. Ele roda no mesmo ambiente que o motor de diagramação, sem depender de uma instalação de LaTeX, e faz a ponte entre os formatos: o EPUB vira a fonte intermediária, o Pandoc converte para a linguagem do diagramador, e o PDF final sai de lá com a página no tamanho certo.
É esse encadeamento que permite produzir vários livros com o mesmo processo em vez de diagramar cada um do zero. Sem ele, cada rodada de revisão do autor viraria retrabalho manual em três arquivos.
Para ver o processo completo, de conversa gravada a livro publicado, veja como funciona a Máquina de Livros, e o resultado dele em o livro da metodologia APE. Se o seu gargalo ainda é anterior (transformar o que você sabe em texto), comece por capturar e transcrever a sua própria fala.
