Cosa fa
Il convertitore da Markdown a HTML trasforma il testo Markdown in markup HTML da incollare in un CMS, un modello di e-mail, una pagina statica o qualsiasi posto che accetti HTML ma non Markdown. È utile per pubblicare un README su un sito, spostare appunti in un editor di blog o verificare esattamente quali tag produce un frammento di Markdown.
L’output è lo stesso HTML generato dai renderer Markdown più diffusi: titoli da <h1> a <h6>, paragrafi <p>, elenchi <ul> e <ol>, blocchi <pre><code> con una classe language- per gli evidenziatori di sintassi e markup <table> per le tabelle in stile GitHub.
Come si usa
- Scrivi o incolla Markdown, carica un file
.mdo fai clic su Esempio. - Scegli le opzioni che ti servono: GitHub Flavored Markdown, a capo come
<br>, ID dei titoli per i link ad ancora, sanificazione per input non affidabili e un documento HTML completo invece di un frammento. - Copia l’HTML o scaricalo come file
.html.
Il risultato si aggiorna mentre scrivi. Lascia disattivata l’opzione del documento completo quando incolli il risultato in una pagina esistente e attivala quando vuoi un file autonomo.
Esempio
Questo Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
diventa questo HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>
Suggerimenti
- Per impostazione predefinita l’HTML grezzo nel Markdown resta com’è, come fa la maggior parte dei renderer. Attiva la sanificazione ogni volta che il Markdown è stato scritto da altri.
- Con gli ID dei titoli puoi collegarti a una sezione con un indirizzo come
page.html#installe costruire un indice partendo dai titoli. - I blocchi di codice mantengono il linguaggio come classe, quindi evidenziatori come Prism o highlight.js li riconoscono senza lavoro extra.
- Per vedere il risultato renderizzato affiancato usa l’anteprima Markdown. Per la direzione opposta usa il convertitore da HTML a Markdown.
Domande frequenti
› Quale sintassi Markdown è supportata?
Tutto CommonMark, come titoli, enfasi, link, immagini, elenchi, citazioni, codice e linee orizzontali. Con GitHub Flavored Markdown attivo hai anche tabelle con allineamento delle colonne, elenchi di attività, barrato e link automatici per gli URL nudi.
› Che cosa fa l'opzione di sanificazione?
Esegue l'escape di tutto l'HTML grezzo nel Markdown, così appare come testo invece di diventare tag, e rimuove link e immagini il cui URL usa uno schema pericoloso come javascript o vbscript. Attivala quando il Markdown proviene da utenti di cui non ti fidi, per esempio commenti o post di un forum.
› Come vengono generati gli ID dei titoli?
Come su GitHub. Il testo del titolo viene messo in minuscolo, la punteggiatura viene rimossa e gli spazi diventano trattini, quindi Getting Started riceve l'id getting-started. I titoli ripetuti ricevono -1, -2 e così via, così ogni ancora resta unica.
› A cosa serve l'opzione documento HTML completo?
Racchiude il risultato in una pagina completa con doctype, set di caratteri UTF-8, tag viewport, un titolo preso dal primo titolo di primo livello e un piccolo foglio di stile leggibile. Salvalo come file .html e si aprirà bene in qualsiasi browser.
› Il mio Markdown viene inviato da qualche parte?
No. La conversione avviene nel browser con la libreria marked e nulla viene caricato su un server.