Convertitore gratuito da Markdown a PDF

Informazioni su Markdown

Markdown è un linguaggio di markup leggero che converte testo semplice in HTML formattato. È ampiamente usato per la documentazione, i blog e la scrittura tecnica perché è facile da leggere e scrivere.

Sintassi Markdown

• #, ##, ### · titoli (h1, h2, h3)
• **testo** · testo in grassetto
• *testo* · testo in corsivo
• [link](url) · collegamenti ipertestuali
• - elemento · liste non ordinate
• 1. elemento · liste ordinate

Domande frequenti

Posso usare HTML in Markdown?

Sì. Markdown supporta l'HTML in linea, quindi puoi incorporare direttamente tag HTML nel tuo Markdown.

Quali dimensioni di pagina sono supportate?

A4, Letter, A3 e A5 sono supportate. I margini sono regolabili tra 0 e 50 millimetri.

La generazione del PDF è lato client?

Sì. Tutta la conversione avviene nel tuo browser. Il tuo Markdown non viene mai inviato ai nostri server.

Come funziona questo convertitore

Uno strumento browser-based per la conversione da Markdown a PDF esegue una pipeline in due fasi. Prima, il sorgente Markdown viene analizzato in HTML da un parser Markdown JavaScript (questa pagina usa marked.js, un parser piccolo, veloce, con licenza MIT, mantenuto dall'organizzazione MarkedJS). Il risultato è l'HTML che si vede nell'anteprima live. Poi, quell'HTML viene convertito in un PDF: questa pagina usa html2pdf.js, che a sua volta racchiude due librerie: html2canvas ridipinge il DOM renderizzato su un canvas off-screen leggendo gli stili calcolati, e jsPDF scrive l'immagine di quel canvas in un oggetto pagina PDF e salva il file.

Le librerie stesse vengono caricate da un CDN pubblico, ma il Markdown viene analizzato e il PDF viene generato interamente sul dispositivo dell'utente. Il browser è il renderer; nulla lascia la pagina.

Una breve storia del PDF

Il PDF è nato come proposta interna di John Warnock, co-fondatore di Adobe, nel 1991. Voleva un modo per condividere documenti che avessero lo stesso aspetto su ogni schermo, ogni stampante, ogni sistema operativo. Il breve documento che lo ha avviato era intitolato «The Camelot Project», e Adobe ha pubblicato la prima specifica PDF il 15 giugno 1993 insieme ad Adobe Acrobat 1.0. Adobe ha gestito il formato per quindici anni prima di pubblicare PDF 1.7 all'ISO. ISO 32000-1:2008 ha reso il PDF uno standard aperto liberamente utilizzabile senza licenza, la data più importante per capire perché ogni moderno strumento, browser e OS può scrivere PDF oggi. ISO 32000-2:2017 (PDF 2.0) ha aggiunto firme digitali migliorate, una migliore gestione di Unicode e agganci formali per l'accessibilità. L'edizione corretta del 2020 è stata resa scaricabile gratuitamente dalla PDF Association nell'aprile 2023, rimuovendo l'ultimo ostacolo economico.

Un PDF è essenzialmente un contenitore strutturato di oggetti disposti per l'accesso casuale, grafica vettoriale (linee e curve di Bézier), immagini raster (tipicamente JPEG o compresse con zlib), font incorporati (Type 1, TrueType, OpenType) e una tabella di riferimenti incrociati che consente ai lettori di saltare ovunque senza analizzare l'intero file. Esistono diversi standard di sottoinsieme PDF degni di nota: PDF/A (archiviazione, ISO 19005, 2005, proibisce tutto ciò che potrebbe compromettere la leggibilità a lungo termine), PDF/X (produzione di stampa con gestione del colore bloccata) e PDF/UA (Accessibilità Universale, ISO 14289-1, 2012, richiede PDF completamente taggati con ordine di lettura, testo alternativo, font incorporati mappati su Unicode e lingua del documento dichiarata).

Formati di pagina

La serie A deriva da ISO 216 (formalizzato nel 1975, riconducibile al DIN 476 tedesco del 1922). Ogni formato A ha lo stesso rapporto d'aspetto √2 (≈ 1,414), il che significa che dimezzando il lato lungo dell'A3 si ottengono due A4 senza sprechi, e dimezzando l'A4 si ottengono due A5. A0 misura esattamente 1 m². I formati nordamericani (Letter, Legal, Tabloid) ignorano √2 e risalgono alle convenzioni coloniali di produzione della carta:

• A4: 210 × 297 mm (8,3 × 11,7 in). Predefinito globale al di fuori del Nord America.
• A3: 297 × 420 mm (11,7 × 16,5 in). Poster, grandi formati.
• A5: 148 × 210 mm (5,8 × 8,3 in). Opuscoli, fanzine.
• Letter: 8,5 × 11 in (215,9 × 279,4 mm). Predefinito negli USA, Canada e Filippine.

Il margine predefinito di 10 mm è più stretto del predefinito di 1 pollice (25,4 mm) di Microsoft Word, ma funziona bene per documenti ricchi di codice o con tabelle dense dove si vuole che ogni colonna rientri.

La limitazione onesta: il testo non è selezionabile

Poiché il convertitore renderizza l'HTML su un canvas e incorpora il canvas come immagine all'interno del PDF, il testo risultante non è selezionabile, non è cercabile e non è accessibile ai lettori di schermo. È un'immagine fedele di ciò che il browser disegnerebbe, ma è un'immagine. Va bene per artefatti visivi come schede di ricette, mood board o dispense stampate; è poco adatto per documenti legali, curriculum che un recruiter vuole scansionare per parole chiave, o qualsiasi cosa che debba superare un audit di accessibilità (WCAG / Section 508 / EN 301 549).

Se è necessario testo selezionabile o un PDF taggato, gli strumenti giusti sono Pandoc (combinato con LaTeX, wkhtmltopdf o weasyprint) o Adobe Acrobat Pro con i suoi strumenti di tagging. Pandoc è il gold standard per la produzione di documenti seri, installabile tramite Homebrew o Chocolatey, funziona dalla riga di comando e offre il controllo tipografico di livello LaTeX completo con note a piè di pagina, bibliografie, citazioni, virgolette intelligenti e legature corrette.

Forzare le interruzioni di pagina

html2pdf.js rispetta le proprietà di frammentazione di stampa CSS. Poiché Markdown consente di incorporare HTML inline, è possibile forzare un'interruzione di pagina incollando:

<div style="break-before: page;"></div>

Funziona anche il vecchio alias page-break-before: always. Altre proprietà utili: break-inside: avoid su una tabella o un blocco di codice ne impedisce la suddivisione tra le pagine; orphans e widows controllano quante righe devono restare insieme in fondo o in cima a una pagina.

Consigli per un output pulito

• Evitare immagini raster enormi. Una singola foto a pagina intera può aggiungere centinaia di kilobyte. Ridimensionare le immagini prima di incorporarle, oppure usare max-width negli stili inline per limitarne le dimensioni di render.
• Tabelle che non si spezzeranno tra le pagine: racchiuderle con <div style="break-inside: avoid">.
• I blocchi di codice necessitano del monospace. Il browser usa il font monospace del sistema operativo quando non è impostato nulla di più specifico: Consolas su Windows, Menlo su macOS, DejaVu Mono su Linux. L'output avrà un aspetto leggermente diverso su ciascuno.
• Testare con una lunghezza del contenuto realistica. Un documento di test breve va bene, ma il layout a volte appare diverso oltre le 10 pagine.
• Letter vs A4. Se si condivide con destinatari statunitensi, scegliere Letter; il resto del mondo si aspetta A4. Formati non corrispondenti non compromettono nulla ma causano piccole stranezze di margini/scalatura alla stampante.

Markdown comune per questo tipo di output

La sintassi supportata è il sottoinsieme in stile GitHub: intestazioni, grassetto e corsivo, elenchi, tabelle, blocchi di codice con semplice evidenziazione della sintassi, citazioni, link e immagini. Note a piè di pagina e diagrammi Mermaid non sono supportati da questa build. Promemoria rapido delle basi:

• Intestazioni: da # H1 a ###### H6.
• Grassetto e corsivo: **bold**, *italic*, ***both***.
• Elenchi: - item per non ordinato, 1. item per ordinato.
• Link e immagini: [text](url) e ![alt](url). Includere sempre il testo alternativo.
• Tabelle: righe separate da pipe con una riga separatrice di trattini.
• Blocchi di codice delimitati: tre apici inversi più un tag di linguaggio opzionale.
• Citazioni: > text.

Un promemoria sulla genealogia di Markdown: John Gruber e Aaron Swartz lo hanno progettato nel 2004 come «un formato di testo semplice facile da leggere e da scrivere.» Lo sforzo di standardizzazione CommonMark è iniziato nel 2014, guidato da John MacFarlane (Pandoc), Jeff Atwood (Stack Overflow / Discourse) e ingegneri di GitHub, Reddit e Meteor. GitHub Flavored Markdown è un superset di CommonMark che aggiunge tabelle, testo barrato, liste di attività e autolink.

Altre domande

Perché il testo nel mio PDF è sfocato?

Perché il convertitore rasterizza la pagina alla densità di visualizzazione del browser. Su un monitor non Retina l'immagine risultante può sembrare sfocata quando ingrandita, poiché il canvas cattura a circa 96 DPI anziché ai tipici 300 DPI della stampa. La soluzione è renderizzare a densità maggiore: html2canvas accetta un'opzione scale (tipicamente 2× per output di qualità Retina), al costo di dimensioni file maggiori.

Perché il mio blocco di codice non ha l'evidenziazione dei colori?

marked.js non include l'evidenziazione della sintassi per impostazione predefinita; avvolge semplicemente i blocchi delimitati in tag <pre><code class="language-…">. L'evidenziazione reale richiede una libreria separata come Prism.js o highlight.js, che questa build non include. Il PDF mostrerà il codice in monospace ma senza il tema di colori verde-e-rosso che ci si potrebbe aspettare da GitHub.

Posso includere note a piè di pagina o un sommario?

Le note a piè di pagina (riferimenti [^1] e definizioni [^1]: definitions) sono una funzionalità di render di GitHub al di fuori della specifica GFM standard e non vengono analizzate da questa build. Un sommario richiede un'estensione Markdown (come il plugin TOC di markdown-it) o la scrittura manuale dell'elenco di link. Per entrambi, Pandoc con il suo flag --toc è lo strumento giusto.

Il PDF sarà taggato per l'accessibilità?

No. L'output è un PDF di tipo immagine-di-pagine senza tag semantici, testo alternativo o indicazioni sull'ordine di lettura; non supererebbe un controllo di conformità PDF/UA. Per il lavoro con requisiti di accessibilità (moduli governativi, documenti del settore pubblico, qualsiasi cosa soggetta a WCAG / EN 301 549 / Section 508), usare Pandoc + LaTeX con un filtro di accessibilità, gli strumenti di tagging di Adobe Acrobat Pro o una pipeline WeasyPrint lato server.

Vengono inviati dati a un server?

No. Il testo non lascia mai il browser. Marked.js analizza il Markdown localmente, html2canvas dipinge su un canvas off-screen, jsPDF costruisce l'oggetto PDF e il browser lo salva. Le librerie stesse vengono caricate da un CDN pubblico con controlli di integrità delle sottorisorsa; vengono recuperate una volta e poi memorizzate nella cache. Una volta che la pagina è caricata funziona offline.

Strumenti correlati