Convertire Markdown in PDF

Il convertitore da Markdown a PDF di FileReshape formatta nel Suo browser un file .md con titoli, elenchi, tabelle, blocchi di codice ed elenchi di attività in stile GitHub, e Lei salva il risultato come PDF con testo selezionabile tramite la finestra di stampa del browser. Il file non viene caricato. Le immagini solo collegate, non incorporate, compaiono come la loro descrizione, e non ci sono colorazione della sintassi né un pulsante di download diretto.

Un file non è stato convertito correttamente? Scrivi a [email protected], possibilmente con un piccolo file di esempio, e verrà corretto.

In breve

Perché trasformare un Markdown in PDF

Il Markdown è il modo in cui sviluppatori, autori e app per appunti come Obsidian, Joplin e Typora conservano il testo: leggibile come testo semplice e formattato quando un'app lo mostra. Fuori da queste app un file .md è solo un muro di cancelletti e asterischi, non certo ciò che vuole inviare per e-mail a un cliente, consegnare o stampare. Questo strumento legge il Markdown nel Suo browser con marked, un parser open source che segue le regole di GitHub Flavored Markdown, e lo impagina come un documento pulito: titoli, testo in grassetto e corsivo, elenchi numerati e puntati, elenchi di attività con caselle di controllo, tabelle con bordi, citazioni e blocchi di codice in un font a spaziatura fissa che vanno a capo invece di uscire dalla pagina. Poi il motore di stampa del browser scrive il PDF, così il testo resta nitido e ricercabile. Il front matter YAML all'inizio del file, usato da blog e generatori di siti statici, viene escluso dal PDF.

Come convertire un Markdown in PDF

  1. Trascini il Suo file .md nel riquadro, oppure faccia clic per sceglierlo. Compare un'anteprima del documento formattato.
  2. Scelga formato pagina, margini e dimensione del testo.
  3. Faccia clic su «Crea PDF». Nella finestra di stampa del Suo browser scelga «Salva come PDF» come stampante o destinazione e salvi il file.

Che cosa sapere su Markdown e PDF

Immagini solo collegate

Di solito il Markdown indica le immagini tramite un indirizzo, come ![Logo](images/logo.png) o un link web. Lo strumento ha solo il file .md, non la cartella che lo contiene, e non scarica nulla dal web, quindi queste immagini compaiono come un piccolo riquadro con la loro descrizione. Le immagini incorporate nel file come data URL vengono stampate. Per avere comunque le immagini nel PDF, apra il Markdown in un editor che le mostra e stampi da lì.

HTML all'interno del Markdown

L'HTML semplice come <br>, <sup>, <details> o una tabella scritta in HTML viene mantenuto. Script, frame, moduli, stili e video incorporati vengono rimossi, perché non appartengono a un documento stampato e potrebbero non essere sicuri.

Nessuna colorazione della sintassi

I blocchi di codice vengono stampati in un font a spaziatura fissa con una cornice leggera, ma senza i colori che un editor usa per parole chiave e stringhe. Le righe di codice lunghe vanno a capo, così niente viene tagliato sul bordo della pagina.

Varianti di Markdown

Tabelle, elenchi di attività, testo barrato e link automatici seguono le regole di GitHub, condivise dalla maggior parte delle app. Le estensioni che hanno solo alcune app, come note a piè di pagina, formule matematiche, diagrammi Mermaid, wiki link tra note o callout di Obsidian, vengono mostrate come semplice testo.

Informazioni sui formati

Markdown

Il Markdown è un formato di testo semplice per scrivere documenti formattati, creato da John Gruber nel 2004. I cancelletti creano i titoli, gli asterischi il grassetto e il corsivo, i trattini gli elenchi. Lo usano GitHub, GitLab, Reddit, Obsidian, le esportazioni di Notion e molti strumenti di documentazione.

  • Un file .md è testo semplice, quindi si apre in qualsiasi editor di testo e funziona bene con i sistemi di controllo versione come Git.
  • GitHub Flavored Markdown (GFM) aggiunge alle regole originali tabelle, elenchi di attività, testo barrato e link automatici.
  • Le immagini di solito sono collegate tramite un indirizzo, quindi si trovano in file separati accanto al file .md o sul web.

PDF

Il PDF (Portable Document Format) è stato creato da Adobe nel 1993 ed è una norma ISO dal 2008. Un PDF appare identico su qualsiasi dispositivo, per questo si usa per contratti, fatture, moduli, manuali e documenti scansionati.

  • Una pagina può contenere testo, grafica vettoriale e immagini, ciascuno collocato con precisione.
  • Un documento scansionato di solito è composto da un'immagine per pagina.
  • Un PDF può essere protetto da una password, necessaria per aprirlo o modificarlo.

Domande frequenti

Il mio file Markdown viene caricato su un server?

No. Il Markdown viene letto e formattato dal Suo browser sul Suo dispositivo, e il PDF viene scritto dalla funzione di stampa del browser. Non viene inviato nulla a un server.

Come elimino la data e l'indirizzo web su ogni pagina?

Disattivi «Intestazioni e piè di pagina» nella finestra di stampa del browser, di solito sotto Altre impostazioni. Così sparisce anche il titolo della pagina in alto.

Perché i miei blocchi di codice non hanno lo sfondo grigio nel PDF?

I browser omettono i colori di sfondo in stampa, a meno che nella finestra di stampa non sia attiva «Grafica di sfondo». La cornice attorno ai blocchi di codice viene stampata in ogni caso.

Posso convertire un README da GitHub?

Sì. Scarichi il file README.md e lo trascini qui. I badge e gli screenshot collegati dal web compaiono come la loro descrizione.