Converti Markdown in PDF senza perdere il documento
Markdown è pensato per uno schermo che scorre. Un PDF ha pagine, e le pagine hanno bordi. La maggior parte dei convertitori ignora questa differenza: passano il file a un browser, premono stampa e restituiscono qualunque cosa ne esca. Ecco perché una tabella perde le sue ultime quattro colonne, perché un'intestazione finisce isolata in fondo a una pagina e perché il logo in cima a un README arriva come una riga di HTML grezzo stampata come testo. Questo strumento invece impagina il documento pensando prima alla carta e poi ti dice cosa ha dovuto fare per arrivarci.
Tabelle che restano dentro i margini
Una tabella Markdown non contiene larghezze di colonna. La sintassi non prevede uno spazio per queste informazioni, quindi un convertitore che passa la tabella direttamente a un browser spera semplicemente che ci stia. Qui ogni tabella viene misurata prima di essere disegnata e adattata alla carta che hai scelto. Una tabella di percorsi file larga quattordici colonne resta comunque dentro i margini, con i valori lunghi che vanno a capo invece di uscire dal bordo, e il risultato ti dice che è stato necessario farlo.
Il problema più silenzioso si presenta a pagina due. Una tabella lunga di solito lascia la riga di intestazione indietro a pagina uno, così il lettore si ritrova con una griglia di numeri senza etichetta. Qui invece l'intestazione si ripete su ogni pagina raggiunta dalla tabella, e una riga non viene mai tagliata a metà da un salto pagina.
Codice che sopravvive ai margini
Il codice racchiuso tra fence mantiene l'evidenziazione e l'etichetta della lingua. Le righe lunghe vanno a capo in modo visibile, invece di essere tagliate dove finisce la carta. Un PDF non ha barra di scorrimento, quindi una riga che non va a capo è una riga con il lato destro mancante. Blocchi indentati, fence senza lingua e codice inline vengono tutti mantenuti per quello che sono.
Le immagini nel tuo README
Un logo e una fila di badge di build quasi mai sono scritti in Markdown. Non c'è modo di centrare un'immagine, quindi i file README usano spesso HTML grezzo. Un convertitore che si rifiuta di renderizzare HTML di solito lo "escapa" invece di eliminarlo, il che significa che il documento si apre con una schermata di tag immagine stampati come testo. Qui il markup viene rimosso e vengono mantenute le immagini e le parole al loro interno, così la parte superiore del documento appare come dovrebbe.
Le immagini vengono recuperate e incorporate nel file invece che collegate, così il PDF funziona anche offline e continuerà a funzionare tra un anno. Se un'immagine non può essere recuperata, il risultato la conta e lo segnala invece di lasciare silenziosamente uno spazio vuoto dove dovrebbe esserci una figura.
I tuoi titoli diventano la navigazione
Ogni PDF contiene una struttura di segnalibri creata dai tuoi titoli, così un documento lungo può essere navigato dalla barra laterale invece che scorrendo. Se chiedi una pagina dei contenuti, ne ottieni una cliccabile, alla profondità di titolo che preferisci. Un unico titolo in cima viene letto come titolo del documento e non inserito nell'elenco, proprio come avviene in un libro invece che in un capitolo.
Le note a piè di pagina restano tali, con un marcatore in apice e un link che riporta alla riga che stavi leggendo. Le task list mantengono le loro caselle, spuntate e non. Le note, gli avvisi e i suggerimenti mantengono la loro barra colorata. Il front matter in cima al file viene trattato come metadati e non appare sulla pagina. Liste di definizioni, barrato, citazioni annidate e tre livelli di elenco annidato vengono tutti resi come sono.
Ti dice cosa non è riuscito a fare
Ogni conversione restituisce un breve resoconto: quante pagine, la direzione del testo, quante tabelle, quanti blocchi di codice, quante immagini sono state incorporate e quante non sono state recuperate. Se manca un carattere in un font, viene elencato. Se chiedi una pagina dei contenuti e il documento non ha titoli da inserire, viene segnalato invece di restituire un file con una pagina vuota all'inizio. Un convertitore che nasconde i propri limiti è il motivo per cui la gente smette di fidarsi dei convertitori.
Scritture che non sono latine
I font viaggiano all'interno del PDF, così un documento si apre allo stesso modo anche su una macchina che non li ha installati. Il testo da destra a sinistra viene valutato blocco per blocco invece che una volta sola per tutto il file, cosa importante perché un documento tecnico in quel tipo di scrittura è spesso metà latino per numero di caratteri, pieno di percorsi file e nomi di classi, e si legge comunque da destra a sinistra. Il codice racchiuso tra fence è escluso da questa valutazione e viene sempre impostato da sinistra a destra, e il resto dell'impaginazione si adatta correttamente: punti elenco, barre di citazione e colonne delle tabelle si spostano. Dove una scrittura non prevede il corsivo, l'enfasi viene resa con il peso invece che inclinando lettere che non sono nate per essere inclinate.
Cosa non farà
LaTeX non viene renderizzato. Un blocco tra i simboli del dollaro viene stampato come testo. Anche Mermaid non viene disegnato: un fence etichettato mermaid esce come blocco di codice con etichetta. Cinese, giapponese e coreano non rientrano tra i font supportati dallo strumento, quindi i caratteri in questi sistemi di scrittura vengono segnalati come mancanti invece che inventati. Questi sono limiti, non difetti, e sono scritti qui così nessuno li scopre dopo aver caricato il file.
La parte pratica
Carica dal tuo dispositivo, da Google Drive o incollando un link a un file. I file Markdown sono accettati con tutte le loro estensioni comuni, così come il testo semplice. La carta può essere A3, A4, A5, Letter, Legal o Tabloid, verticale o orizzontale, con margini stretti, normali o larghi. Numeri di pagina e evidenziazione della sintassi sono attivi a meno che tu non li disattivi. Invia un file e ricevi un PDF; inviane diversi e arrivano come ZIP, oppure come un unico PDF unito con numerazione continua delle pagine se lo richiedi. Il testo resta vero testo, così può essere selezionato, cercato e copiato, invece di essere appiattito in un'immagine di parole.
Cosa ottieni
- Tabelle che restano dentro i margini, con la riga di intestazione ripetuta su ogni pagina raggiunta
- Codice evidenziato con le righe lunghe che vanno a capo invece di essere tagliate
- Immagini incorporate nel file, incluse quelle scritte in HTML grezzo
- Una struttura di segnalibri dai tuoi titoli e una pagina dei contenuti cliccabile se la desideri
- Font inclusi all'interno del PDF, così il file appare uguale su ogni computer che lo apre
- Un resoconto scritto di tutto ciò che il convertitore non ha potuto fare, inclusi glifi e immagini mancanti
E dopo?
Lavori invece da un file Word? Word in PDF segue la stessa strada verso la carta. Unisci il risultato con il resto di una relazione usando Unisci PDF. Poi riduci la dimensione del file prima di inviarlo con Comprimi PDF.