Zo gebruik je deze tool
- Typ Markdown in de editor of klik op ‘Voorbeeld proberen’ om een document met tabellen en een taaklijst te laden.
- Bekijk hoe de preview verandert terwijl je typt. Schakel over naar ‘HTML-broncode’ om de gegenereerde markup te zien.
- Schakel GitHub Flavored Markdown of enkele regeleinden in of uit, afhankelijk van waar je de tekst publiceert.
- Kopieer de HTML naar een CMS of e-mail, of download het resultaat als .html- of .md-bestand.
Hoe het werkt
Markdown wordt omgezet met marked, een veelgebruikte opensource-parser die de CommonMark-specificatie volgt en, als de GFM-optie is ingeschakeld, GitHub Flavored Markdown ondersteunt: tabellen met pipe-tekens en kolomuitlijning, taaklijsten, ~~doorhalen~~ en automatische links voor kale URL’s. Voetnoten, wiskundige notatie en Mermaid-diagrammen vallen niet onder deze specificaties en worden als platte tekst weergegeven.
Markdown kan raw HTML bevatten, en die HTML wordt ongewijzigd doorgegeven, zoals bij de meeste Markdown-renderers. Om je veilig te houden, wordt het voorbeeld nooit in deze pagina ingevoegd. Het wordt weergegeven in een sandboxframe waarin geen scripts mogen worden uitgevoerd, formulieren mogen worden verzonden, pop-ups mogen worden geopend of deze site mag worden benaderd. Het content security policy blokkeert scripts, externe stylesheets, lettertypen en frames. Een <script>-tag of een onclick-attribuut in je Markdown is zichtbaar in de HTML-broncode, maar wordt nooit uitgevoerd. Links in het voorbeeld worden getoond, maar openen niet; kopieer de URL als je de link wilt volgen.
Het voorbeeld gebruikt een neutrale stylesheet die lijkt op die van gangbare README-renderers; je website of GitHub kan dezelfde HTML er anders laten uitzien. De gekopieerde HTML is een fragment zonder opmaak; het gedownloade .html-bestand bevat een eenvoudige stylesheet, zodat het eruitziet als het voorbeeld. Gedownloade of gekopieerde HTML wordt niet opgeschoond. Als de HTML scripts bevat, worden die uitgevoerd op de plek waar je de HTML plakt of opent.
Voorbeelden
Een README controleren voordat je deze pusht
Plak README.md om te controleren of de tabelkolommen netjes uitlijnen, de taaklijst als selectievakjes wordt weergegeven en de codeblokken correct zijn afgebakend, voordat je het bestand naar GitHub pusht.
Schrijven voor een CMS dat HTML ondersteunt
Schrijf een blogbericht in Markdown en klik daarna op ‘HTML kopiëren’. Plak de <h2>-, <p>- en <ul>-markup in de HTML-editor van het CMS.
Regeleinden zoals in een chat
Tekst uit een chatapp bevat regels met enkele regeleinden. Schakel ‘Enkele regeleinden behandelen als <br>’ in om die regels gescheiden te houden in plaats van ze samen te voegen tot één alinea.
Veelgestelde vragen
Is het veilig om Markdown van een onbekende bron te plakken?
Ja, voor het bekijken van een voorbeeld. De gerenderde HTML wordt weergegeven in een sandboxframe waarin scripts zijn uitgeschakeld. Zelfs een <script>-tag of gebeurtenisafhandelaar in de tekst doet hier dus niets. Wees voorzichtig met waar je de geëxporteerde HTML plakt, want die wordt niet opgeschoond.
Waarom worden mijn afbeeldingen niet weergegeven?
Afbeeldingen van andere websites zijn standaard geblokkeerd, zodat het voorbeeld geen netwerkverzoeken doet. Schakel ‘Afbeeldingen van andere websites laden’ in om ze weer te geven. Relatieve paden zoals ./docs/screenshot.png werken niet, omdat de bestanden hier niet aanwezig zijn.
Ondersteunt de preview voetnoten, wiskundige notatie of diagrammen?
Nee. De preview ondersteunt CommonMark en GitHub Flavored Markdown (tabellen, taaklijsten, doorhalen en automatische links). Voetnoten, LaTeX-wiskunde en Mermaid-diagrammen zijn uitbreidingen en worden in deze preview als platte tekst weergegeven.
Waarom begint een enkel regeleinde geen nieuwe regel?
In standaard Markdown wordt een enkel regeleinde binnen een alinea behandeld als een spatie. Eindig de regel met twee spaties, laat een lege regel open of schakel ‘Enkele regeleinden behandelen als <br>’ in.
Privacy
Markdown wordt in je browser omgezet en niet geüpload of opgeslagen. De preview laadt niets van internet, tenzij je afbeeldingen van andere websites toestaat. In dat geval worden die afbeeldingen rechtstreeks bij hun hosts opgevraagd.