Wat het doet
De Markdown naar HTML converter zet Markdown-tekst om in HTML-opmaak die je kunt plakken in een CMS, een e-mailsjabloon, een statische pagina of elke plek die HTML accepteert maar geen Markdown. Handig om een README op een website te publiceren, notities naar een blogeditor te verhuizen of precies te zien welke tags een stukje Markdown oplevert.
De uitvoer is dezelfde HTML die populaire Markdown-renderers maken: koppen <h1> tot en met <h6>, alinea’s <p>, lijsten <ul> en <ol>, <pre><code>-blokken met een language--class voor syntaxmarkering en <table>-opmaak voor tabellen in GitHub-stijl.
Zo gebruik je het
- Typ of plak Markdown, upload een
.md-bestand of klik op Voorbeeld. - Kies de opties die je nodig hebt: GitHub Flavored Markdown, regeleinden als
<br>, kop-ID’s voor ankerlinks, opschonen voor onbetrouwbare invoer en een volledig HTML-document in plaats van een fragment. - Kopieer de HTML of download hem als
.html-bestand.
Het resultaat wordt bijgewerkt terwijl je typt. Laat de optie voor een volledig document uit als je het resultaat in een bestaande pagina plakt, en zet hem aan als je een los bestand wilt.
Voorbeeld
Deze Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOS
wordt deze 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>
Tips
- Ruwe HTML in de Markdown blijft standaard ongewijzigd, zoals bij de meeste renderers. Zet opschonen altijd aan als iemand anders de Markdown heeft geschreven.
- Met kop-ID’s kun je naar een sectie linken met een adres als
page.html#installen een inhoudsopgave uit de koppen bouwen. - Codeblokken behouden hun taal als class, zodat markeerders als Prism of highlight.js ze zonder extra werk herkennen.
- Gebruik de Markdown-preview om het gerenderde resultaat ernaast te zien. Voor de andere richting is er de HTML naar Markdown converter.
Veelgestelde vragen
› Welke Markdown-syntaxis wordt ondersteund?
Alles uit CommonMark, zoals koppen, nadruk, links, afbeeldingen, lijsten, citaten, code en horizontale lijnen. Met GitHub Flavored Markdown aan krijg je ook tabellen met kolomuitlijning, takenlijsten, doorhalen en automatische links voor losse URL's.
› Wat doet de optie opschonen?
Die escapet alle ruwe HTML in de Markdown, zodat die als tekst verschijnt in plaats van tags te worden, en verwijdert links en afbeeldingen waarvan de URL een onveilig schema gebruikt, zoals javascript of vbscript. Zet hem aan als de Markdown komt van gebruikers die je niet vertrouwt, bijvoorbeeld reacties of forumberichten.
› Hoe worden de kop-ID's gemaakt?
Net als op GitHub. De koptekst wordt in kleine letters gezet, leestekens worden verwijderd en spaties worden streepjes, dus Getting Started krijgt de id getting-started. Herhaalde koppen krijgen -1, -2 enzovoort, zodat elk anker uniek blijft.
› Waarvoor dient de optie volledig HTML-document?
Die verpakt het resultaat in een complete pagina met doctype, UTF-8-tekenset, viewport-tag, een titel uit de eerste kop van niveau één en een klein, goed leesbaar stylesheet. Sla het op als .html-bestand en het opent netjes in elke browser.
› Wordt mijn Markdown ergens naartoe gestuurd?
Nee. De omzetting draait in je browser met de bibliotheek marked en er wordt niets naar een server geüpload.