Markdown in HTML

Il convertitore Markdown to Markdown trasforma la sorgente Markdown - un README, un changelog, una bozza del blog, una serie di note di rilascio - nell'HTML che un browser o un CMS effettivamente rende Incolla o digita Markdown a sinistra e ottieni HTML semantico a destra: le intestazioni diventano h HTML6, il codice recintato diventa pre e codice con una classe, le liste diventano ul e ol e le estensioni GitHub come tabelle, elenchi di attività e barrato vengono gestite nel modo in cui GitHub le esegue.

Markdown è un formato di scrittura in testo semplice, non un formato di visualizzazione Ovunque appaia su una pagina - un sito di documenti, un blog statico, un modello di posta elettronica, un campo CMS che accetta solo HTML - qualcosa deve compilarlo prima Fare che nel browser, piuttosto che tirare un parser nella tua build o incollare la tua bozza in un servizio che non controlli, è il modo più veloce per ottenere il markup e andare avanti.

Tutto funziona lato client. Il convertitore è un parser scritto a mano, non un wrapper attorno a un'API remota, quindi i tuoi post inediti, i documenti interni e le note di rilascio privato non lasciano mai la pagina. Attiva/disattiva markdown con aroma di GitHub, ID di ancoraggio intestazione, interruzioni di riga a nuova riga e pass-through HTML RAW, quindi copia l'HTML, scarica un file .html o prendi un sommario generato.

Markdown permette HTML grezzo in linea, che rende la domanda di sicurezza reale piuttosto che teorica: un documento contenente un tag script è valido Markdown, e un convertitore che lo passa attraverso produce HTML che verrà eseguito quando renderizzato Output qui è sfuggito di default per quel motivo, quindi un file Markdown da una fonte non attendibile non può contrabbandare markup nella tua pagina Se stai convertendo il tuo contenuto e vuoi che l'HTML grezzo sia conservato, questa è una scelta deliberata piuttosto che l'impostazione predefinita L'altra cosa da sapere è che Markdown non ha una specifica singola Qui è implementato GitHub Flavored Markdown, che copre tabelle, elenchi di attività, codice barrato e recintato, e quelle sono estensioni piuttosto che parte della sintassi originale, quindi un renderer CommonMark rigoroso non le mostrerà.