Convert2EPUB
Menu
← Blog

Come convertire Markdown in EPUB: con Pandoc o con un convertitore senza installazione

Ultimo aggiornamento: 11 novembre 2026

Il modo più rapido per convertire Markdown in EPUB è Pandoc: esegui pandoc book.md -o book.epub e ottieni un EPUB valido. Se non vuoi installare nulla, carica il file .md su un convertitore web come Convert2EPUB. In entrambi i casi, la qualità dell’ebook dipende soprattutto da come strutturi titoli e metadati prima di convertire.

Cosa ti serve per convertire un file Markdown in EPUB?

Ti serve un file Markdown con una struttura dei titoli chiara, un titolo e un autore, e uno strumento che generi EPUB. Pandoc è lo strumento standard da riga di comando. Un convertitore nel browser fa lo stesso lavoro senza installare nulla.

Prima di convertire, assicurati che il file di partenza sia pronto:

  • Un titolo # per ogni capitolo. Per impostazione predefinita Pandoc divide un EPUB in capitoli in corrispondenza dei titoli di livello 1, secondo la guida utente di Pandoc (in inglese). Se scrivi i capitoli con ##, cambiali o imposta il livello di divisione (lo vediamo più avanti).
  • Titolo e autore in un blocco di metadati all’inizio del file, non solo in un titolo.
  • Immagini con percorsi relativi che funzionino dalla cartella in cui esegui il comando, più il testo alternativo.
  • Niente HTML grezzo di cui non puoi fare a meno. I tag semplici di solito sopravvivono, ma script, iframe e trucchi CSS non c’entrano niente in un file per e-reader.

Come si converte Markdown in EPUB con Pandoc?

Installa Pandoc, metti un blocco di metadati YAML all’inizio del file ed esegui un solo comando. Pandoc costruisce l’indice a partire dai titoli.

1. Aggiungi i metadati

Pandoc legge i metadati dell’EPUB da un blocco YAML nel file Markdown, oppure da un file YAML separato, come descrive il manuale di Pandoc. Un blocco minimo:

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

lang conta più di quanto si pensi. Su alcuni e-reader controlla la sillabazione e la sintesi vocale. La data la scegli tu, quindi usa la data di pubblicazione che vuoi mostrare.

2. Esegui il comando

pandoc book.md -o book.epub --toc --toc-depth=2
  • --toc-depth stabilisce quanti livelli di titolo compaiono nell’indice. Secondo il manuale di Pandoc il valore predefinito è 3, quindi vengono elencati i livelli 1, 2 e 3. Per un romanzo, di solito 1 o 2 dà un risultato più pulito.
  • --epub-cover-image=cover.jpg fa lo stesso lavoro del campo cover-image. Pandoc consiglia una copertina più piccola di 1000px in larghezza e in altezza.
  • --epub-title-page=false rimuove il frontespizio generato, se ne hai scritto uno tuo.

3. Unisci più file

Molti autori tengono un file per capitolo. Passali nell’ordine giusto e Pandoc li unisce:

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

Dai ai file un nome che inizia con un numero, così l’ordine della shell corrisponde all’ordine di lettura. Metti il blocco di metadati solo nel primo file.

4. Uno stile leggero

Pandoc applica un foglio di stile predefinito. Per cambiarlo, passa --css=epub.css. Tieni il CSS al minimo: imposta il rientro dei paragrafi e i margini dei titoli, e lascia stare famiglia e dimensione del carattere. Gli e-reader permettono di scegliere entrambi, e se li forzi togli questo controllo a chi legge.

Come strutturare i titoli perché capitoli e indice escano bene?

Usa # per i capitoli e ## per le sezioni al loro interno, e non saltare livelli. Il menu di navigazione dell’EPUB viene generato da questi titoli, quindi la struttura che scrivi è la struttura che riceve chi legge.

Il tuo MarkdownCosa succede nell’EPUB (impostazioni predefinite di Pandoc)
# ChapterInizia un nuovo file di capitolo e compare nell’indice
## SectionCompare nell’indice (profondità 3 per impostazione predefinita) ma resta dentro il file del capitolo
### SubsectionCompare nell’indice solo se la profondità lo consente
Testo in grassetto formattato come un titoloNon è un titolo; non comparirà nell’indice

Due problemi comuni:

  • Un libro con un solo titolo #. L’intero libro diventa un unico file enorme. Il manuale di Pandoc precisa che questa opzione riguarda solo la composizione interna dell’EPUB, non il modo in cui i capitoli appaiono a chi legge, e che alcuni e-reader possono essere lenti con file di capitolo molto grandi. Per un documento lungo con pochi titoli di primo livello, usa --split-level=2 o 3.
  • Il titolo del libro scritto come # e anche i capitoli come #. Il titolo compare allora come un capitolo. Metti il titolo nel blocco YAML e riserva # ai veri capitoli.

Se anche dopo l’indice non ti sembra giusto, la nostra guida su come sistemare un indice EPUB mancante o difettoso ti accompagna nei controlli.

Si può convertire Markdown in EPUB senza installare Pandoc?

Sì. Un convertitore web che accetta i file .md ti permette di caricare il file, impostare titolo e autore e scaricare l’EPUB. È adatto alle conversioni occasionali e a chi non vuole usare la riga di comando.

Ecco come si confrontano i due approcci:

PandocConvertitore nel browser
Installazione necessariaSìNo
Ripetibile in uno script di build o in CISìNo
CSS, caratteri e filtri personalizzatiControllo completoLimitati alle impostazioni dello strumento
Unione di più fileSì, elencandoliPrima uniscili in un unico file
Ideale perLibri che ricompili spessoConversioni rapide e occasionali

Il riquadro di caricamento di Convert2EPUB elenca Markdown tra i formati accettati, con un limite di 100 MB. Ha impostazioni per titolo, autore, testo adattabile o layout fisso e dispositivo di destinazione. Il sito descrive il suo modello Standard gratuito come adatto alle impaginazioni semplici come i romanzi, che è proprio quello che sono quasi tutti i manoscritti in Markdown. Se non sei sicuro che l’adattabile sia la scelta giusta, leggi il nostro confronto tra EPUB adattabile e a layout fisso. Per la prosa, lo è.

Cosa devo controllare prima di inviare l’EPUB a un e-reader?

Apri il file in almeno un’app di lettura vera e segui una breve checklist. La maggior parte dei problemi della conversione da Markdown a EPUB si vede nei primi cinque minuti.

  • Indice: apri il menu di navigazione. Devono esserci tutti i capitoli, in ordine, con nomi sensati.
  • Copertina e titolo: la copertina deve comparire nella vista della libreria, e titolo e autore devono essere corretti.
  • Immagini: controlla che ogni immagine compaia, si adatti allo schermo e non abbia bordi indesiderati.
  • Blocchi di codice e tabelle: le righe lunghe nei blocchi di codice possono uscire dallo schermo sugli e-reader piccoli. Mandale a capo o accorciale. Per uno schermo da 6 pollici, è meglio riscrivere le tabelle larghe come elenchi.
  • Note a piè di pagina: Pandoc trasforma le note di Markdown in note collegate. Toccane una e verifica che ti riporti indietro.
  • Validazione: se vuoi pubblicare tramite uno store, passa il file a EPUBCheck, il validatore sostenuto dal W3C che gli store usano comunemente. Rileva problemi che gli e-reader perdonano in silenzio.

Per i piccoli schermi e-ink, il nostro articolo sulle impostazioni EPUB per un e-reader e-ink da 6 pollici spiega cosa impostare nel file e cosa sul dispositivo.

Se preferisci saltare la configurazione, puoi caricare il tuo file .md su Convert2EPUB e scaricare un EPUB adattabile.

Posso leggere su Kindle un EPUB creato da Markdown?

Sì. Invia l’EPUB al tuo Kindle per email o tramite l’app Send to Kindle, senza bisogno di convertirlo in MOBI o AZW3. La pagina di Convert2EPUB indica che Send to Kindle accetta un EPUB così com’è. La nostra guida su come inviare un EPUB al tuo Kindle spiega i passaggi.

Domande frequenti

Pandoc può convertire Markdown direttamente in MOBI o AZW3?

No. Pandoc genera EPUB, non MOBI o AZW3. I flussi di lavoro attuali per Kindle accettano direttamente l’EPUB, quindi di solito una conversione a parte non serve. Solo i Kindle molto vecchi hanno bisogno di MOBI.

Perché il mio EPUB è un unico capitolo gigante?

Per impostazione predefinita Pandoc divide i capitoli in corrispondenza dei titoli di livello 1. Se il tuo Markdown ha un solo # o nessuno, tutto finisce in un unico file. Trasforma i titoli dei capitoli in #, oppure imposta --split-level=2.

Come aggiungo un’immagine di copertina?

Aggiungi cover-image: cover.jpg al blocco YAML, oppure passa --epub-cover-image=cover.jpg. Il manuale di Pandoc consiglia un’immagine più piccola di 1000px in larghezza e in altezza. Indica il percorso relativo alla cartella da cui esegui il comando.

La formattazione Markdown, come grassetto, elenchi e citazioni, sopravvive?

Sì. Gli elementi Markdown standard diventano i loro equivalenti HTML dentro l’EPUB, e li visualizza lo stile proprio dell’e-reader. Le estensioni variano da uno strumento all’altro, quindi controlla nel risultato la sintassi meno comune, come elenchi di definizioni o elenchi di attività.

Posso convertire un’intera cartella di file Markdown?

Con Pandoc, sì. Elenca i file in ordine o usa un glob come *.md, come fa una guida di DEV Community (in inglese) con il repository di una documentazione. Numera i nomi dei file, così l’ordine è prevedibile.

Pronto a convertire il tuo PDF? È gratis per i normali documenti di testo, senza bisogno di un account.

Converti un PDF in EPUB →