HTML naar Markdown converter

Een WordPress-artikel overzetten naar Hugo, een Confluence-pagina als notities archiveren of een opgemaakte e-mail opschonen voor een documentatiewiki: het komt allemaal neer op HTML omzetten naar Markdown. Deze converter vertaalt koppen, alinea’s, lijsten, links, afbeeldingen en codeblokken naar hun Markdown-equivalenten, zodat de inhoud zijn structuur behoudt zonder de HTML-overbodigheden.

Zo zet je HTML om naar Markdown

  1. 1

    HTML plakken

    Volledige pagina's, opgemaakte e-mailteksten of fragmenten, alles wordt verwerkt.

  2. 2

    Omzetten

    Koppen, alinea's, lijsten, links, afbeeldingen en codeblokken worden naar Markdown omgezet.

  3. 3

    De Markdown kopiëren

    Plaats de uitvoer in Obsidian, Hugo, Jekyll, Notion of een Git-repository.

HTML naar Markdown converteren

De converter doorloopt de DOM en genereert Markdown voor elk herkend element. Wrapper-tags zoals <div>, <span>, <section> en <article> worden verwijderd en hun inhoud blijft op het juiste nestniveau behouden.

Elementtoewijzing

HTML Markdown-uitvoer
<h1> tot <h6> Koppen # tot ######
<strong>, <b> **text**
<em>, <i> *text*
<code> inline `text`
<pre><code> codeblok met drie backticks eromheen, met taal indien opgegeven
<a href> [text](url)
<img src alt> ![alt](src)
<ul><li> - item
<ol><li> 1. item
<blockquote> > quote
<hr> ---

Wat gebeurt er met de rest

Markdown kan niet elk HTML-element uitdrukken. Tags zonder Markdown-equivalent worden verwijderd en alleen hun tekstinhoud blijft behouden:

  • <table>: de tekst in de cellen blijft behouden, maar het tabelraster gaat verloren. Gebruik een converter die tabellen ondersteunt wanneer de structuur belangrijk is.
  • <del>, <u> en andere inline-stijlen: de tekst blijft, de opmaak niet.
  • <video>, <audio>, <iframe>: uit deze insluitingen komt niets voort dat in Markdown weer te geven valt.
  • <details> / <summary>: de tekst erin blijft behouden, het uitklapwidget niet.

Voor verliesvrije heen-en-weerconversies zet je om vanaf de oorspronkelijke Markdown-bron in plaats van vanaf gerenderde HTML.

Veelgestelde vragen

Eenvoudige <div>- en <span>-wrappers worden verwijderd en hun inhoud wordt op het juiste nestniveau weergegeven. Div-elementen die alleen voor de lay-out dienen, worden onzichtbaar in Markdown, wat voor documentatie meestal precies is wat je wilt.

Ja. <pre><code class="language-js"> wordt een omheind blok met js als taalhint. Ingesprongen codeblokken zonder taal vallen terug op gewone omheinde blokken.

De tekst in de <table>-cellen blijft behouden, maar het raster zelf niet: rijen en kolommen worden niet behouden, dus de structuur gaat verloren. Gebruik een converter die tabellen ondersteunt wanneer de structuur belangrijk is.

Bijna, maar subtiele opmaak (referentielinks, harde regeleinden met twee spaties aan het eind, alternatieve nadrukmarkeringen) kan worden genormaliseerd. Bewaar de oorspronkelijke Markdown als je verliesvrij heen en weer wilt converteren.

Gerelateerde tools

Tool beschikbaar in andere talen