Domande frequenti

Risposte alle domande più comuni su MarkPDF

Quale sintassi Markdown è supportata?

MarkPDF supporta la sintassi CommonMark: titoli, paragrafi, enfasi, elenchi, link, immagini, blocchi di codice, citazioni e linee orizzontali, oltre a tabelle in stile GitHub, testo barrato e link automatici. Le formule si scrivono tra $ … $ e $$ … $$.

PDF di testo o PDF immagine: che differenza c’è?

Ci sono due modi per esportare. «Scarica PDF (testo)» usa il motore di stampa del browser: il testo resta selezionabile e ricercabile, i link funzionano e il file è leggero; scegli «Salva come PDF» nella finestra di stampa. «Download rapido (immagine)» salva le pagine come immagini con un clic (circa 180 DPI in A4): è identico all’anteprima, ma il testo non è selezionabile e né i motori di ricerca né i sistemi di selezione dei CV (ATS) possono leggerlo. Nei browser integrati nelle app (WhatsApp, Facebook, Instagram…) spesso non si può stampare, quindi lì viene proposta prima la versione immagine.

Formule matematiche ed evidenziazione del codice sono supportate?

Sì. I blocchi di codice sono evidenziati con highlight.js (oltre 190 linguaggi) e le formule tra $ … $, $$ … $$, \( … \) o \[ … \] vengono rese con KaTeX.

C’è un limite alle dimensioni del file?

Tutto viene elaborato nel browser, quindi il limite reale dipende dal tuo dispositivo. Di solito file Markdown di qualche decina di KB (decine di migliaia di parole) funzionano senza problemi. I documenti molto grandi possono richiedere un po’ più di tempo per essere visualizzati.

Come scelgo il carattere giusto?

Per l’italiano basta il carattere predefinito; quelli per arabo, hindi e altri sistemi di scrittura si caricano da soli. Per il cinese semplificato scegli Noto Sans SC o Source Han Sans, per il cinese tradizionale Noto Sans TC, per il giapponese Noto Sans JP e per il coreano Noto Sans KR. Per documenti multilingue è consigliato Source Han Sans.

Quanto è veloce la conversione?

Dipende da lunghezza e complessità del documento. Un articolo normale di 2000 parole richiede di solito 2-3 secondi. Documenti lunghi con molte tabelle o blocchi di codice possono richiedere 5-10 secondi. Tutto avviene nel browser, senza trasferimenti in rete.

Conservate il contenuto dei miei documenti?

No. Tutta l’elaborazione di MarkPDF avviene nel tuo browser e il contenuto non viene mai inviato ai nostri server. La privacy è il motivo principale per cui abbiamo scelto di elaborare tutto nel browser.

Posso convertire più file insieme?

La versione attuale converte un documento alla volta. La conversione in blocco non è ancora disponibile.

Posso personalizzare l’aspetto del PDF?

Nel pannello delle impostazioni scegli carattere, dimensione, formato carta (A4, Letter, A5) e margini; le scelte vengono ricordate su questo dispositivo. CSS personalizzato e intestazioni/piè di pagina non sono ancora disponibili.

C’è un’API?

Per ora no. MarkPDF funziona interamente nel browser. Se ti serve generare PDF nella tua applicazione, dai un’occhiata alle librerie open source che usiamo (markdown-it + html2pdf.js).

Quali browser sono supportati?

MarkPDF funziona in tutti i browser moderni: Chrome 80+, Firefox 75+, Safari 14+ ed Edge 80+. Per un’esperienza migliore usa una versione recente di Chrome o Edge. Internet Explorer non è supportato.

Si può usare da smartphone?

Sì. L’interfaccia si adatta a smartphone e tablet. Sugli schermi piccoli editor e anteprima stanno uno sotto l’altro; passa dall’uno all’altra con il pulsante «Anteprima».

Posso inserire immagini?

Sì. Usa la sintassi delle immagini di Markdown per inserire immagini online. La versione attuale non permette di caricare immagini dal dispositivo: carica prima l’immagine su un servizio di hosting e poi usa il suo link.

Posso esportare in altri formati?

Per ora il formato principale è il PDF. L’esportazione in HTML è in sviluppo e altri formati come Word (.docx) potrebbero arrivare in futuro.

Dove trovo aiuto?

MarkPDF non offre assistenza individuale. La maggior parte delle domande trova risposta in queste FAQ, nella guida e nelle guide alla risoluzione dei problemi, che spiegano nel dettaglio i problemi di caratteri, codifica e impaginazione.