Come si usa
- Scrivi Markdown nell’editor oppure fai clic su «Prova un esempio» per caricare un documento con tabelle e un elenco di attività.
- Osserva l’anteprima aggiornarsi mentre scrivi. Passa a «Sorgente HTML» per vedere il markup generato.
- Attiva o disattiva GitHub Flavored Markdown e le interruzioni di riga singole in base a dove verrà pubblicato il testo.
- Copia l’HTML in un CMS o in un’email oppure scarica il risultato come file .html o .md.
Come funziona
Markdown viene convertito con marked, un parser open source molto diffuso che segue la specifica CommonMark e, con l’opzione GFM attiva, GitHub Flavored Markdown: tabelle con pipe e allineamento delle colonne, elenchi di attività, ~~testo barrato~~ e collegamenti automatici per gli URL non formattati. Note a piè di pagina, formule matematiche e diagrammi Mermaid non fanno parte di queste specifiche e vengono mostrati come testo semplice.
Markdown può contenere HTML grezzo, che viene mantenuto invariato, come avviene nella maggior parte dei renderer Markdown. Per proteggerti, l’anteprima non viene mai inserita in questa pagina. Viene visualizzata in un frame sandbox che non può eseguire script, inviare moduli, aprire finestre pop-up o accedere a questo sito; inoltre, la Content Security Policy blocca script, fogli di stile esterni, font e frame. Un tag <script> o un attributo onclick nel tuo Markdown viene mostrato nel codice HTML, ma non viene mai eseguito. I link nell’anteprima sono visibili ma non si aprono; se vuoi visitarne uno, copia l’URL.
L’anteprima usa un foglio di stile neutro, simile a quello dei renderer README più comuni; il tuo sito web o GitHub potrebbe applicare uno stile diverso allo stesso HTML. L’HTML copiato è un frammento senza stili; il file .html scaricato include un foglio di stile di base per avere l’aspetto dell’anteprima. L’HTML copiato o scaricato non viene ripulito: se contiene script, verranno eseguiti nel punto in cui lo incolli o lo apri.
Esempi
Controllare un README prima di inviarlo
Incolla README.md per controllare che le colonne della tabella siano allineate, che l’elenco di attività venga visualizzato come caselle di controllo e che i blocchi di codice abbiano le delimitazioni corrette, prima di caricare il file su GitHub.
Scrivere per un CMS che accetta HTML
Scrivi una bozza di un articolo del blog in Markdown, poi fai clic su «Copia HTML» e incolla i tag <h2>, <p> e <ul> nell’editor HTML del CMS.
Interruzioni di riga in stile chat
Il testo di un’app di chat contiene righe separate da singole interruzioni di riga. Attiva «Considera le singole interruzioni di riga come <br>» per mantenerle separate invece di unirle in un unico paragrafo.
Domande frequenti
È sicuro incollare Markdown proveniente da una fonte sconosciuta?
Sì, per l’anteprima. L’HTML renderizzato viene mostrato in un frame sandbox con gli script disattivati, quindi anche un tag <script> o un gestore di eventi nel testo non può fare nulla. Fai attenzione a dove incolli l’HTML esportato, perché non viene ripulito.
Perché le mie immagini non vengono visualizzate?
Per impostazione predefinita, le immagini di altri siti web sono bloccate per evitare richieste di rete durante l’anteprima. Attiva «Carica immagini da altri siti web» per visualizzarle. I percorsi relativi, come ./docs/screenshot.png, non funzionano perché i file non si trovano qui.
Supporta note a piè di pagina, formule o diagrammi?
No. Supporta CommonMark e GitHub Flavored Markdown (tabelle, elenchi di attività, testo barrato e link automatici). Note a piè di pagina, formule LaTeX e diagrammi Mermaid sono estensioni che questa anteprima mostra come testo semplice.
Perché una singola interruzione di riga non va a capo?
In Markdown standard, una singola interruzione di riga all’interno di un paragrafo viene trattata come uno spazio. Aggiungi due spazi alla fine della riga, lascia una riga vuota oppure attiva «Considera le singole interruzioni di riga come <br>».
Privacy
Markdown viene convertito nel browser e non viene caricato né salvato. L’anteprima non carica contenuti da Internet, a meno che tu non consenta le immagini da altri siti web; in tal caso, le immagini vengono richieste direttamente ai rispettivi host.