Markdown è ottimo per scrivere, ma chi riceve un documento spesso si aspetta una pagina web o un PDF. La buona notizia: convertire Markdown è facile e nella maggior parte dei casi non serve una catena di strumenti complessa.
Ecco quattro modi per farlo, dal più rapido al più configurabile, più una serie di consigli per ottenere un risultato professionale.
Confronto rapido
| Metodo | HTML | Installazione | Ideale per | |
|---|---|---|---|---|
| Esportazione da un editor nel browser | ✅ | ✅ (stampa) | Niente | Documenti di tutti i giorni, condivisione veloce |
| VS Code + estensione | ✅ | ✅ | Editor + estensione | Chi scrive già in VS Code |
| Pandoc | ✅ | ✅ | Pandoc (+ un motore PDF) | Libri, articoli scientifici, pipeline automatiche |
| Uno script (markdown-it, marked) | ✅ | — | Node.js | Siti web personalizzati e processi di build |
1. Esportare da un editor nel browser
La strada più veloce è un editor che esporta direttamente. In Markdown Preview Editor apri o incolla il documento, dalla versione online o dalla tua copia, e usa i pulsanti nell’intestazione:
- HTML crea un unico file
.htmlautonomo. Stili, evidenziazione del codice, formule, diagrammi e le immagini aperte insieme al documento vengono incorporati, così il file si vede correttamente su qualsiasi computer e può essere allegato a un’email o caricato ovunque così com’è. - Stampa apre la finestra di stampa del browser. Scegli Salva come PDF come destinazione per ottenere un PDF. Viene stampato solo il documento visualizzato: niente barra degli strumenti, niente editor.
- Salva scarica il sorgente Markdown come file
.md.
Poiché tutto avviene nel browser, questo metodo va bene anche per i documenti che preferiresti non caricare su un convertitore online.
Ottenere un PDF pulito dalla finestra di stampa
- Imposta Margini su Predefiniti o Minimi, a seconda di quanto testo vuoi per pagina.
- Disattiva Intestazioni e piè di pagina per rimuovere data e URL dai bordi della pagina.
- Attiva Grafica di sfondo se vuoi gli sfondi dei blocchi di codice e le righe alternate delle tabelle.
- Usa un tema chiaro per la stampa: consuma meno inchiostro ed è più leggibile su carta.
2. VS Code con un’estensione
VS Code ha un’anteprima Markdown integrata, ma nessun pulsante di esportazione. Estensioni come Markdown PDF o Markdown Preview Enhanced aggiungono comandi per esportare in HTML e PDF. È comodo se VS Code è già il tuo editor; lo stile del risultato dipende dall’estensione e alcune scaricano un browser headless al primo utilizzo.
3. Pandoc, il convertitore universale
Pandoc converte tra decine di formati ed è lo strumento di riferimento per libri, articoli accademici e documentazione automatizzata. Dopo averlo installato, la conversione è un solo comando:
bash# Da Markdown a una pagina HTML completa
pandoc report.md -o report.html --standalone --metadata title="Report"
# Da Markdown a PDF (serve un motore PDF, ad es. una distribuzione LaTeX)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Da Markdown a Word, se qualcuno insiste
pandoc report.md -o report.docx
Senza --standalone, Pandoc produce solo un frammento HTML, utile se lo inserisci in una pagina esistente. L’output PDF richiede un motore separato: una distribuzione LaTeX oppure un motore basato su HTML come WeasyPrint. Il punto di forza di Pandoc è il controllo: modelli, citazioni, sezioni numerate e riferimenti incrociati.
4. Poche righe di JavaScript
Se Markdown fa parte del tuo sito o del tuo processo di build, una libreria è l’opzione più flessibile. Con markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
I plugin aggiungono note a piè di pagina, elenchi di attività, formule e altro. Ricorda che l’output è sicuro solo quanto il suo input: se il Markdown proviene da altre persone, sanifica l’HTML (per esempio con DOMPurify) prima di pubblicarlo.
Consigli per un HTML e un PDF migliori
Parti da un titolo chiaro
I convertitori prendono il titolo del documento dal nome del file, dal primo titolo o dai metadati espliciti. Dai a ogni documento un nome di file descrittivo e un unico titolo #: l’HTML e il PDF esportati saranno facili da riconoscere nella cartella dei download o in una scheda del browser.
Tieni le immagini accanto al documento
Usa percorsi relativi come images/chart.png e tieni i file nella stessa cartella. Quando apri l’intera cartella in Markdown Preview Editor, le immagini vengono risolte e incorporate nell’esportazione HTML. Le immagini remote non caricate nell’anteprima non vengono incorporate.
Controlla le interruzioni di pagina
Markdown non ha una sintassi per l’interruzione di pagina. Per i documenti da stampare, inizia le sezioni principali con un titolo ## e tieni le tabelle brevi: i browser evitano di spezzare le righe di una tabella, ma una tabella enorme continuerà comunque nella pagina successiva. Negli strumenti che consentono HTML grezzo e stili in linea, come Pandoc, puoi inserire <div style="page-break-after: always"></div>.
Verifica formule e diagrammi prima di esportare
Nella maggior parte degli strumenti, formule e diagrammi vengono generati da librerie JavaScript. Controllali prima nell’anteprima: leggi le nostre guide alle formule matematiche in Markdown e ai diagrammi Mermaid. Nell’esportazione HTML di Markdown Preview Editor sono salvati come markup e immagini già pronti, quindi il file esportato non ha bisogno di script.
Scegli il tema consapevolmente
Le esportazioni HTML scure sono piacevoli a schermo, ma poco adatte alla carta. Esporta pensando al mezzo che userà il lettore.
Domande frequenti
Come si converte Markdown in PDF gratis?
Apri il documento in un visualizzatore Markdown come Markdown Preview Editor, clicca su Stampa e scegli Salva come PDF nella finestra di stampa. Per un output automatizzato o in stile libro, usa lo strumento a riga di comando gratuito Pandoc.
Come si converte Markdown in HTML senza installare nulla?
Usa un editor nel browser con esportazione HTML. Markdown Preview Editor crea un file HTML autonomo con gli stili inclusi, direttamente nel tuo browser.
Le immagini saranno incluse nell’HTML esportato?
Le immagini locali aperte insieme al documento vengono incorporate nel file HTML, che quindi funziona da solo. Le immagini che restano su server remoti non vengono incorporate.
Posso convertire Markdown in Word (DOCX)?
Sì, con Pandoc: pandoc input.md -o output.docx. In alternativa, esporta in HTML e apri il file in Word, che mantiene gran parte della formattazione.