Afwaardering naar HTML-converter
Transformeer Markdown-tekst naar productieklare HTML-code met ondersteuning voor live previews.
Transformeer Markdown-tekst naar productieklare HTML-code met ondersteuning voor live previews.
Markdown is een lichtgewicht opmaaktaal gemaakt door John Gruber in 2004 om schrijvers gestructureerde HTML te laten produceren met behulp van platte tekstconventies: hash-tekens voor koppen, sterretjes voor nadruk, koppeltekens voor lijsten, ingesprongen blokken voor code. Het formaat is de standaard geworden voor README-bestanden, technische documentatie, blogconcepten, statische sitegeneratoren en elke context waarin het geschreven tekst leesbaar moet zijn als platte tekst en als weergegeven uitvoer. Het converteren van Markdown naar HTML is de weergavestap die de bron omzet in een webpagina.
Deze converter maakt gebruik van de gemarkeerde bibliotheek, de meest gebruikte Markdown-renderer in JavaScript. Marked ondersteunt CommonMark en GitHub Flavored Markdown (GFM), wat betekent dat tabellen, omheinde codeblokken, takenlijsten, doorhalen en automatisch koppelen allemaal correct werken naast de standaard Markdown-functies.
De uitvoer is eenvoudige HTML: semantische tags voor koppen, alinea's, lijsten, koppelingen en afbeeldingen, plus class hooks voor codeblokken waar tools voor syntaxisaccentuering deze verwachten. De uitvoer kan netjes in elk CMS worden geplakt, kan worden ingebed in statische sitegeneratoren of dient als zelfstandige .html. Er is geen CSS of JavaScript toegevoegd; het vormgeven van het resultaat wordt overgelaten aan uw downstream-context.
Markdown is het formaat waar schrijvers en ontwikkelaars de voorkeur aan geven; HTML is het formaat dat browsers weergeven. De meeste statische sitegeneratoren en CMS-platforms converteren Markdown achter de schermen naar HTML, maar soms heb je de conversie als een op zichzelf staande stap nodig: plakken in een CMS dat geen Markdown-ondersteuning heeft, HTML voor e-mails genereren, een snel voorbeeld produceren of de weergegeven uitvoer extraheren voor verdere verwerking.
HTML is ook het canonieke formaat voor alle inhoud die uiteindelijk in een browser wordt weergegeven. E-mailnieuwsbrieven opgebouwd uit Markdown-concepten, documentatiepagina's ingebed in grotere HTML-applicaties en blogposts geplakt in editors die HTML verwachten, profiteren allemaal van een schone conversie.
Plak Markdown, haal HTML op.
Marked maakt gebruik van een two-pass-architectuur. De lexer tokeniseert de invoer in tokens op blokniveau (koppen, paragrafen, lijsten, codeblokken) en inline tokens (nadruk, links, afbeeldingen). De parser doorloopt de tokenstroom en zendt HTML uit, waarbij renderer-hooks worden toegepast voor elk tokentype.
GitHub Flavoured Markdown-extensies zijn standaard ingeschakeld: tabellen (met behulp van pipe-syntaxis), omheinde codeblokken (drievoudige backticks met taalhints), takenlijsten (- [ ] en - [x]), doorhalen (met dubbele tildes) en automatische URL-koppeling. Codeblokken zenden voorverpakte code uit met optionele taalklasse voor downstream-syntaxisaccentuering.
Het opschonen van de output wordt overgelaten aan de downstream-consumenten. Marked zendt alles uit wat de invoer oplevert, inclusief onbewerkte HTML die is ingebed in de Markdown. Als u niet-vertrouwde invoer accepteert, voert u de uitvoer uit via DOMPurify of een vergelijkbaar HTML-opschoningsmiddel voordat u deze in een browser weergeeft.