Anteprima Markdown
Vedi il tuo Markdown visualizzato mentre scrivi, nel tuo browser, con tutto l'HTML grezzo protetto invece che eseguito.
Gira interamente nel tuo browser. Non viene caricato, registrato o salvato niente.
L'HTML che produce
Scrivi Markdown a sinistra e leggilo a destra. Tutto avviene nel tuo browser, quindi una bozza che non sei ancora pronto a mostrare a nessuno non deve essere mostrata prima a un server.
Come funziona
Il documento viene letto riga per riga in blocchi — titoli, paragrafi, elenchi, citazioni, codice, tabelle — e poi il testo di ogni blocco viene letto in cerca dei pezzi in linea: enfasi, frammenti di codice, link e immagini. Tutto quello che il renderizzatore non riconosce resta testo.
L'HTML grezzo viene protetto invece che lasciato passare. Se scrivi un tag, vedi il tag. È una deviazione deliberata rispetto alla maggior parte dei renderizzatori, che permettono un sottoinsieme scelto, e il motivo è che scegliere bene quel sottoinsieme è un lavoro andato storto in progetti molto più grandi, più di una volta.
Un link viene creato solo quando il suo indirizzo comincia con uno schema di un elenco corto, controllato sulla forma decodificata dell'indirizzo e non su quello che è stato scritto. Quando viene rifiutato il testo resta e il link no, così puoi vedere che c'era qualcosa.
Esempi
| Caso | Dati inseriti | Risultato |
|---|---|---|
| Enfasi e codice in linea | **bold**, *italic* and `code`. | <p><strong>bold</strong>, <em>italic</em> and <code>code</code>.</p> |
Domande frequenti
Il mio documento viene inviato da qualche parte?
No. Il renderizzatore è JavaScript che gira in questa pagina. Non viene caricato niente, non viene registrato niente e non viene salvato niente: puoi staccare la rete e lo strumento continua a funzionare.
Perché il mio HTML compare come testo?
Perché viene protetto di proposito. Markdown permette che un documento contenga HTML, e lasciar passare quell'HTML significa decidere quali tag e quali attributi siano sicuri, una decisione sottile, che cambia man mano che cambiano i browser, e che è stata sbagliata più di una volta da progetti con molte più risorse. Proteggere tutto non ha quel modo di fallire. Il costo è che un documento che si appoggia all'HTML in linea non si vedrà come si vede su GitHub, ed è lo scambio che si sta facendo.
È esattamente CommonMark?
No, e dire di sì sarebbe fuorviante. È un sottoinsieme, più le tabelle, gli elenchi di attività e il barrato del sapore di GitHub. Copre titoli, paragrafi, enfasi, frammenti e blocchi di codice, link, immagini, elenchi annidati, citazioni e righe. I link per riferimento, le note a piè di pagina e i blocchi di HTML non sono implementati.
Perché le immagini remote non compaiono?
Perché questa pagina non si permette di caricare immagini da altri siti. Scaricarne una direbbe a quel server che stai leggendo questo documento, e a che ora, che è proprio la fuga che un'anteprima locale esiste per evitare. Il tag dell'immagine è nell'HTML in uscita, quindi funziona dovunque tu lo incolli: semplicemente non parte da qui.
Cosa succede a un link come javascript:…?
Non diventa un link. Lo schema viene confrontato con un elenco corto — http, https, mailto, tel, ftp, oppure nessuno schema nel caso di un percorso relativo — e il controllo viene fatto sull'indirizzo decodificato, perché un browser risolve le entità di un attributo prima di agire. Il testo del link resta visibile così puoi vedere cosa c'era.
Da sapere
- L'HTML mostrato dall'anteprima è l'HTML che ti dà lo strumento. C'è un solo risultato, non uno sicuro da mostrare e uno diverso da copiare.
- I titoli non ricevono un attributo id. Un id preso dal tuo documento condividerebbe lo spazio dei nomi con quelli di questa pagina, e una collisione romperebbe la pagina attorno all'anteprima.
- I link verso altri siti portano rel="nofollow noopener noreferrer", così una pagina aperta da qui non ottiene nessun controllo su questa.