Che cosa fa questo strumento
Entra Markdown, esce HTML.
# Titolo
Qualcosa in **grassetto** e un [link](https://x.dev).
<h1>Titolo</h1>
<p>Qualcosa in <strong>grassetto</strong> e un <a href="https://x.dev">link</a>.</p>
Il GitHub Flavored Markdown è attivo: tabelle, elenchi di attività, barrato e link automatici vengono letti. Un blocco recintato tiene il suo linguaggio in class="language-js", che è ciò che gli evidenziatori si aspettano.
Finalmente, le note a piè di pagina
Ada scrisse il primo algoritmo[^1].
[^1]: Sulle note di Menabrea, 1843.
<p>Ada scrisse il primo algoritmo<sup class="footnote-ref"><a href="#fn-1" id="fnref-1">1</a></sup>.</p>
<section class="footnotes">
<ol>
<li id="fn-1"><p>Sulle note di Menabrea, 1843. <a href="#fnref-1">↩</a></p></li>
</ol>
</section>
marked, la libreria dietro questo strumento, non ha una regola per le note. [^1] veniva quindi letto come link di riferimento e [^1]: Sulle note di Menabrea, 1843. come la sua definizione: il segno diventava un link a una pagina chiamata come la nota, e il testo della nota non compariva da nessuna parte. Era un difetto vero, trovato scrivendo questa pagina e corretto. Le note sono numerate nell’ordine dei segni, e un segno senza nota dietro resta il testo che è.
L’HTML è tuo, e non è ripulito
Un [link innocuo](javascript:alert(1)) e <div onclick="rubare()">HTML grezzo</div>.
Entrambi passano intatti, ed è il Markdown che mantiene la promessa: il formato consente HTML grezzo, e un convertitore che lo togliesse mentirebbe sul tuo documento. Il risultato, qui, è mostrato come testo e non viene mai inserito nella pagina stessa.
La conseguenza è tua: se il Markdown viene da qualcun altro — un commento, una segnalazione, un modulo — sanifica l’HTML prima di pubblicarlo. Una libreria come DOMPurify lo fa in una chiamata, e il suo posto è dove l’HTML viene pubblicato, non qui.
Che cosa non ottieni
- Un documento. Niente
<html>, niente<head>, nessuna codifica dichiarata, nessun foglio di stile: questo è un frammento da incollare dentro qualcosa. - Ancore sui titoli. GitHub mette un
idsu ogni titolo; è una convenzione di visualizzazione, non Markdown, quindi gli<h2>escono nudi. - Un
<br>per ogni a capo. Un a capo singolo dentro un paragrafo resta uno spazio, come vuole la specifica. Due spazi a fine riga, o una riga vuota, fanno quello che ti aspetti.
Privato per progettazione
Tutto viene eseguito localmente nel browser con JavaScript. I tuoi dati non vengono mai caricati, quindi lo strumento è sicuro per contenuti sensibili e funziona anche offline.