Trasformare il Markdown in un PDF
Il Markdown è il modo più semplice di scrivere un documento e il più scomodo di spedirne uno.
Hai scritto gli appunti, il README, la specifica, il rapporto. Nel tuo editor è perfetto. Poi qualcuno lo chiede in PDF, e le possibilità sono: installare una catena di strumenti, incollare tutto in un elaboratore di testi e sistemare la formattazione a mano, oppure caricarlo in un repository e fotografare la pagina.
Incollalo qui, piuttosto. L'anteprima a destra è come sarà il PDF, e il pulsante lo trasforma in uno.
Che cosa sopravvive al viaggio
Tutto quello che ti aspetti dal Markdown in stile GitHub:
- Titoli — di tutti i livelli, con le spaziature che un documento deve avere
- Elenchi — puntati, numerati e annidati
- Tabelle — con bordi e una riga di intestazione colorata
- Codice — in linea così, e a blocchi che mantengono l'indentazione
- Citazioni, righe orizzontali, grassetto, *corsivo* e collegamenti
- Immagini, purché siano data-URI o URL raggiungibili
L'anteprima e il PDF sono disegnati dallo stesso foglio di stile, quindi ciò che vedi è davvero ciò che viene stampato. Non c'è una seconda impaginazione pronta a sorprenderti.
Due stili
- Documento sobrio — un carattere con grazie e un'interlinea generosa. La scelta giusta per un rapporto, una proposta, un testo disteso, tutto ciò che una persona legge dall'inizio alla fine.
- Stile README — un carattere senza grazie con titoli sottolineati, più vicino a come appare un README su una piattaforma di codice. La scelta giusta per documentazione e note tecniche.
Impostazione della pagina
A4 o Letter, verticale od orizzontale, e un margine che indichi in millimetri. L'orizzontale vale la pena ricordarlo per qualsiasi cosa con tabelle larghe o righe di codice lunghe: è la differenza tra una tabella che ci sta e una che va a capo.
I numeri di pagina sono attivi per impostazione predefinita e compaiono centrati in fondo a ogni pagina. Disattivali per un documento di una sola pagina, dove aggiungono solo disordine.
Non esce niente dal tuo dispositivo
Il Markdown viene reso e il PDF viene scritto dentro il tuo browser. Non viene caricato nulla, quindi:
- Specifiche non pubblicate, appunti interni e lavoro per clienti restano dove sono
- Non c'è nessun limite di dimensione dovuto a un caricamento
- Funziona offline una volta caricata la pagina
- Il tuo testo resta in questo browser tra una visita e l'altra, così una scheda chiusa non fa perdere il lavoro — e resta solo in questo browser
Perché le pagine sono dipinte, non composte
Ogni pagina viene disegnata come immagine e collocata nel PDF, invece di essere scritta come testo PDF. È voluto: i caratteri standard del PDF non sanno codificare affatto hangul, kana, sinogrammi o cirillico, e un documento Markdown può essere in qualsiasi lingua.
Disegnare la pagina usa i caratteri del tuo sistema, quindi ogni scrittura viene resa correttamente. Il prezzo è che il testo nel PDF finito non è selezionabile — lo stesso compromesso che fa Word in PDF, per la stessa ragione. Se ti serve testo selezionabile e il documento è solo in alfabeto latino, Creatore di CV mostra com'è l'altro approccio.
Che cosa converte la gente
- Un README o una pagina di documentazione, per chi non usa una piattaforma di codice
- Appunti di riunione scritti in Markdown, da inoltrare come documento
- Una specifica o una proposta buttata giù in un editor di testo
- Appunti di studio da stampare o leggere su un tablet
- Un changelog o una nota di rilascio da allegare a un'e-mail
- Materiale didattico scritto in Markdown e distribuito in PDF
Buono a sapersi
- L'HTML grezzo dentro il tuo Markdown viene ripulito prima del rendering, quindi un documento incollato non può eseguire nulla
- Un documento molto lungo richiede qualche secondo per pagina — tutto il lavoro è locale
- Le immagini da internet compaiono solo se il sito consente a un'altra pagina di leggerle; quelle incollate come data-URI funzionano sempre
- Per il senso opposto, o semplicemente per scrivere Markdown, usa l'Editor Markdown
- Per unire il risultato a un altro PDF, usa Unire PDF
Come si usa
- Incolla il tuo Markdown a sinistra, oppure premi Apri un .md per caricare un file
- Controlla l'anteprima a destra — sarà così il PDF
- Scegli formato, orientamento, margine e stile
- Spunta Aggiungere i numeri di pagina se li vuoi
- Premi Crea il PDF, poi Scarica il PDF
Strumenti correlati
- Editor Markdown — scrivere Markdown con barra degli strumenti e anteprima dal vivo
- Word in PDF — lo stesso motore PDF, partendo da un .docx
- Da PDF a testo — riprendere il testo semplice da un PDF
- Unire PDF — unire questo PDF ad altri
- Numerare le pagine di un PDF — numerare un PDF esistente
- Comprimere PDF — alleggerire il file prima di spedirlo
