Markdown naar HTML

Markdown naar HTML is een gratis tool die Markdown-fragmenten omzet in onbewerkte HTML-code voor websites, contentsystemen en ontwikkelprocessen.

Wat zet Markdown naar HTML om?

De tool zet Markdown-opmaak om in de bijbehorende HTML-elementen. Een kop wordt een heading-element, een link wordt een anchor-element en een opsomming met bullets wordt een ongeordende lijst met lijstitems.

Markdown is een opmaaktaal voor platte tekst die veel wordt gebruikt voor README-bestanden, technische documentatie, beschrijvingen van issues en content voor statische sites. Omzetten naar HTML is handig als het doelsysteem HTML verwacht in plaats van Markdown, bijvoorbeeld een websitetemplate, e-mailsysteem of veld in een contentmanagementsysteem.

Markdown kent verschillende varianten. CommonMark, GitHub Flavored Markdown en applicatiespecifieke parsers kunnen tabellen, takenlijsten, regeleinden en ingesloten HTML verschillend verwerken. De broninformatie van de tool vermeldt geen specifieke variant. Controleer daarom alle syntax die verder gaat dan gewone koppen, alinea's, links en lijsten voordat je het resultaat in gebruik neemt.

Hoe zet ik Markdown om naar HTML?

Voer de brontekst in het veld Markdown in, start de conversie en bekijk of kopieer daarna de gegenereerde code uit het veld HTML.

1. Plak een volledig fragment, niet slechts een deel van een opmaakmarkering.
2. Zet de tekst om en controleer de elementstructuur in de geretourneerde HTML.
3. Test links, geneste lijsten en codeblokken in de applicatie waarin ze worden weergegeven.
4. Voeg afzonderlijk de opmaak van je site toe als het doelsysteem nog geen geschikte CSS bevat.

De conversie vindt plaats op de server. Je invoer wordt via HTTPS naar de server verzonden en niet opgeslagen. Omdat de tekst voor verwerking je apparaat verlaat, moet je geen inloggegevens, privésleutels of vertrouwelijk materiaal invoeren als het beleid van je organisatie servertools niet toestaat.

Hoe lees ik de geretourneerde HTML?

Lees het resultaat als onbewerkte HTML-code met elementen die de structuur van de Markdown weergeven. Je kunt deze code mogelijk in een bestaande pagina, template of contentveld plaatsen, maar het is niet per definitie een volledig HTML-document met een doctype, metadata, stijlen en scripts.

Dit is een eenvoudig voorbeeld met een kop. De invoer als platte tekst is:

# Release notes

Het gebruikelijke HTML-resultaat is:

<h1>Release notes</h1>

Een korte lijst voer je zo in:

- Alpha

- Beta

De bijbehorende structuur is een ongeordende lijst met twee lijstitem-elementen:

<ul>

<li>Alpha</li>

<li>Beta</li>

</ul>

De meeste fouten in Markdown leveren geen formele parserfout op. Een niet-afgesloten opmaakmarkering, verkeerde inspringing of ontbrekende spatie na een lijstmarkering kan in plaats daarvan als gewone tekst verschijnen. Lijkt de geretourneerde HTML geldig, maar klopt de structuur niet, vergelijk dan de uitvoerelementen met de bedoelde documenthiërarchie.

• Controleer of koppen het verwachte niveau gebruiken en niet onnodig van het ene naar het andere niveau springen.
• Controleer of geneste lijstitems in de Markdown-bron consequent zijn ingesprongen.
• Bekijk de doelen van links voordat je publiceert, vooral bij content van derden.
• Controleer omheinde codeblokken zorgvuldig. Een niet-afgesloten omheining kan de rest van een document opnemen.
• Let op onbewerkte HTML in de bron, want verschillende Markdown-implementaties kunnen deze behouden, escapen of weigeren.

Details van de conversie

Bij conversie van Markdown verandert de structuur, niet de onderliggende taal van de tekst. Letters met accenten, niet-Latijnse schriften, cijfers en gewone leestekens kunnen als tekstinhoud in de gegenereerde elementen blijven staan. HTML-gevoelige tekens moeten mogelijk als entiteiten worden gecodeerd als ze letterlijk moeten verschijnen en niet als opmaak dienen.

Spaties en lege regels kunnen van invloed zijn op de verwerking. Een lege regel scheidt doorgaans alinea's, terwijl inspringing een geneste lijst of een codeblok kan maken. Ook de verwerking van regeleinden verschilt per Markdown-variant. Eén nieuwe regel in de bron levert daarom niet altijd een zichtbare HTML-regeleinde op.

Lege invoer bevat geen zinvolle documentstructuur om te converteren. Zeer lange invoer kun je beter in een lokaal buildproces verwerken. Daar kun je versiebeheer toepassen, tests uitvoeren en de content consequent converteren met dezelfde parser als in de productieomgeving. Geen enkele converter kan bepalen of een kopniveau, linkdoel of lijsthiërarchie semantisch juist is voor je project.

Wanneer is het nuttig om Markdown naar HTML om te zetten?

Conversie is nuttig als een volgend systeem HTML accepteert, maar het bronmateriaal in Markdown is geschreven of aangeleverd. Denk aan het controleren van documentatie van derden voordat je die importeert, het opsporen van fouten in een build voor een statische site, het voorbereiden van release notes voor een editor die alleen HTML accepteert of het beoordelen van gegenereerde opmaak vóór ingebruikname.

Markdown omzetten naar HTML is meestal niet zinvol als alleen een machine de content leest en de Markdown al in de vereiste indeling werkt. Ook kan een vroege conversie in een verwerkingsproces latere bewerkingen lastiger maken als auteurs in Markdown moeten blijven werken.

Minificeer de HTML niet terwijl je fouten in de structuur opspoort. Leesbare opmaak maakt verkeerd geneste en onverwachte elementen makkelijker herkenbaar. Is de uitvoer gecontroleerd en klaar voor productie, dan kan een HTML-minificator overbodige witruimte verminderen.

Veelgestelde vragen

Bevat de omgezette HTML ook CSS-opmaak?

HTML beschrijft de structuur, terwijl CSS het grootste deel van de vormgeving bepaalt. Een heading-element kan er op verschillende sites anders uitzien, omdat de browser, applicatie of het thema de opmaak levert. Voeg CSS toe in het doelsysteem of hergebruik de bestaande CSS. Verwacht niet dat de Markdown-bron de uiteindelijke weergave bepaalt.

Kan ik Markdown-tabellen en takenlijsten omzetten?

De ondersteuning hangt af van de Markdown-variant die de parser gebruikt. Tabellen en selectievakjes voor takenlijsten zijn veelvoorkomende uitbreidingen, maar behoren niet tot de universele Markdown-syntax. Converteer een kleine, representatieve selectie en controleer de geretourneerde elementen voordat je erop vertrouwt in een groter document.

Kan ik niet-vertrouwde Markdown veilig omzetten?

Behandel niet-vertrouwde Markdown ook na de conversie als niet-vertrouwde content. Afhankelijk van de parser en het doelsysteem moeten ingesloten HTML of onveilige linkschema's mogelijk worden opgeschoond. Deze converter wijzigt de indeling, maar conversie alleen is geen beveiligingsfilter.

Kan ik de HTML in WordPress of een ander CMS plakken?

Meestal wel, als de editor een HTML- of codeweergave heeft en de geretourneerde elementen toestaat. Sommige contentmanagementsystemen schonen geplakte opmaak op, verwijderen niet-ondersteunde attributen of veranderen de witruimte tussen alinea's. Bekijk een voorbeeld en controleer de opgeslagen versie, want het CMS kan de content na verzending aanpassen.

Waarom wordt mijn codeblok niet goed weergegeven?

Controleer of de begin- en eindmarkering overeenkomen en elk op een afzonderlijke regel staan. Ingesprongen codeblokken kunnen ook verkeerd worden verwerkt als de omringende lijst niet consequent is ingesprongen. Als syntaxiskleuring nodig is, moet het doelsysteem eventuele taalaanduidingen herkennen en zelf een script of stijlen voor de markering leveren.

Moet ik de Markdown na de conversie bewaren?

Bewaar de Markdown als dit de bewerkbare hoofdbron is. Sla de gegenereerde HTML afzonderlijk op of maak deze tijdens het buildproces opnieuw, zodat latere wijzigingen in beide indelingen niet uiteen gaan lopen. Valideer vóór publicatie de links en bekijk het fragment in het daadwerkelijke doelsysteem. Vertrouw niet alleen op de onbewerkte code.