Converti Markdown in PDF

Istruzioni: Markdown in PDF

1. Apri il file .mdSeleziona un file Markdown o trascinalo sullo strumento. Vanno bene le esportazioni da app di note, wiki e repository di codice, purché usino la sintassi Markdown standard.
2. Imposta formato e dimensione di baseIn «Formato pagina» scegli «A4» o «Letter USA (8,5 × 11 pollici)», poi la «Dimensione carattere» del testo normale. Con una dimensione più piccola, una tabella larga o una riga di codice lunga stanno meglio nella pagina.
3. Crea il PDF e scaricaloPremi «Crea il PDF» e salvalo. Aprilo una volta per controllare titoli, tabelle ed eventuali segnaposto delle immagini prima di inoltrarlo.

Un esempio pratico

Il README.md di un progetto contiene un titolo, due sezioni, un elenco numerato per l’installazione, un blocco di codice shell e una tabella a tre colonne. Con A4 e la dimensione di base predefinita di 11 pt, il titolo (#) è composto a 22 pt (11 × 2), i titoli di sezione (##) a 17,6 pt (11 × 1,6), il blocco di codice in Courier a 9,68 pt (11 × 0,88) su una fascia grigia e il testo della tabella a 10,12 pt (11 × 0,92).

La larghezza del testo, 171,9 mm (210 mm meno due margini di 19,05 mm), viene divisa in parti uguali, quindi ognuna delle 3 colonne della tabella riceve circa 57,3 mm (171,9 ÷ 3). Il risultato si scarica come README.pdf.

Cosa fa e quali limiti ha

• Le immagini compaiono come segnaposto [image: testo alternativo], perché i file a cui rimandano non vengono caricati.
• Sono cliccabili solo i link http, https e mailto; i link relativi appaiono come testo formattato.
• Note a piè di pagina, formule matematiche e codice di diagrammi non vengono resi come tali.
• Lo stile è fisso: niente temi né CSS personalizzato.
• Le scritture da destra a sinistra e quelle complesse come l’arabo, l’hindi e il thai non vengono impaginate correttamente.

Markdown in PDF: cosa c’è da sapere

Il Markdown è comodo da scrivere, ma chi non fa lo sviluppatore preferisce ricevere un documento piuttosto che un file pieno di cancelletti e asterischi. Questo strumento interpreta il tuo Markdown con marked, una libreria open source con licenza MIT, seguendo la specifica CommonMark più due aggiunte di GitHub: tabelle e barrato. Il documento così ottenuto viene poi impaginato su fogli A4 o Letter in un unico stile, sobrio e leggibile.

Elementi che escono formattati

• Titoli, paragrafi, grassetto, corsivo e barrato
• Codice in linea e blocchi di codice delimitati, composti in un font monospaziato su sfondo grigio
• Elenchi puntati, numerati e annidati
• Citazioni e linee orizzontali
• Tabelle, disegnate come una griglia semplice
• Link, che restano cliccabili nel PDF

L’aspetto è fisso: non ci sono temi e non puoi applicare un tuo CSS. Le due cose che controlli sono il formato pagina e la dimensione di base del carattere. Così lo strumento resta rapido da usare e il risultato coerente, il che si addice a dispense, documentazione e relazioni più che a brochure curate graficamente.

Quando ti serve

• Un README per chi non lavora nel repository

  Le note di configurazione di un progetto scritte in Markdown possono arrivare a un cliente o a un responsabile come PDF che si apre ovunque, con i passaggi di installazione in elenchi numerati e i comandi in blocchi di codice su sfondo grigio.

• Appunti di riunione trasformati in una dispensa

  Appunti presi al volo in Markdown, con un titolo per argomento, punti elenco per le decisioni e una piccola tabella di responsabili e scadenze, diventano una pagina da stampare per la riunione successiva.

• Un elaborato scritto in un editor di testo semplice

  Il portale del corso accetta solo PDF, ma tu scrivi in Markdown. Converti il file definitivo e carica un documento in cui titoli, citazioni e link alle fonti mantengono la formattazione.

Perché le immagini diventano segnaposto

Il Markdown richiama le immagini con un percorso o un indirizzo web, per esempio ![Mappa del sito](immagini/mappa.png). Questa pagina non carica file esterni al sito, quindi le immagini richiamate non vengono scaricate. Al loro posto il PDF mostra un segnaposto [image: testo alternativo] con la descrizione scritta tra parentesi quadre, così chi legge capisce che lì c’era un’immagine. Scrivere testi alternativi sensati nel tuo Markdown, quindi, ripaga.

Quando le immagini contano, ricavane un PDF con JPG in PDF o PNG in PDF e uniscilo al testo impaginato con Unisci PDF.

Le lingue e i font che le reggono

L’italiano, l’inglese e le altre lingue scritte in alfabeto latino usano Helvetica e Courier, font standard che ogni lettore PDF ha già, quindi non serve incorporare nulla. Il greco e il cirillico sono composti in Roboto, il cinese e il giapponese in Droid Sans Fallback (entrambi con licenza Apache-2.0) e il coreano in Nanum Gothic (SIL Open Font License); ciascuno viene incorporato come sottoinsieme che contiene solo i caratteri usati dal documento. Il font per cinese e giapponese è un download di circa 4 MB e quello per il coreano di circa 2 MB, e il browser scarica ciascuno solo quando il Markdown contiene davvero quei caratteri.

Le righe in coreano vanno a capo tra una parola e l’altra, come si compone normalmente il testo coreano. L’arabo, l’ebraico e le altre scritture da destra a sinistra, così come le scritture complesse come l’hindi e il thai, non vengono impaginati correttamente. Per i documenti in queste lingue conviene arrivare al PDF con un programma di videoscrittura o un browser che le supporti.

Qualità e peso del risultato

Tutto il testo del PDF è testo vettoriale: nitido a qualsiasi ingrandimento, ricercabile e copiabile. Dato che non vengono incorporate immagini e i font sono ridotti a sottoinsiemi, un tipico documento Markdown produce un file leggero, facile da mandare per email. I link continuano a funzionare nei lettori che li supportano. Per una copia stampata con i numeri di pagina, passa il risultato da Numera pagine.

Sintassi che non viene resa

• Immagini, che diventano segnaposto come spiegato sopra.
• Uno stile tuo: CSS personalizzato, temi, colori e scelta dei font.
• Estensioni fuori da CommonMark, a parte le tabelle e il barrato di GitHub. Note a piè di pagina, formule matematiche e diagrammi scritti come codice non fanno parte di questo insieme: aspettati di vederne il testo sorgente, non il risultato visivo.
• File di testo semplice. Se il tuo file non è davvero Markdown, TXT in PDF mantiene ogni riga e ogni spazio esattamente come li hai scritti.

Interpretazione e impaginazione avvengono entrambe in questa scheda del browser; il Markdown e il PDF che ne risulta restano sul tuo dispositivo. Ecco come verificarlo.