Markdown-converter

Ondersteunt bidirectionele conversie tussen Markdown en HTML met realtime voorbeeldweergave. Ondersteunt GFM uitgebreide syntaxis, code-highlighting, KaTeX wiskundige formules en Mermaid-diagrammen, geschikt voor documentschrijven, blogpublicatie en e-mail rich text generatie.

Gebruiksinstructies

🚀 Snelstart

Plak de inhoud in het invoerveld aan de linkerkant.
Kies de conversiemodus (→HTML of →Markdown).
De inhoud wordt automatisch geconverteerd en het resultaat verschijnt rechts.
Preview/HTML-uitvoer: bij Markdown → HTML worden KaTeX/Mermaid standaard gerenderd.

📌 Veelvoorkomende scenario's

Blog/documentatie-preview: controleer snel hoe Markdown wordt gerenderd en welke kleuren worden gebruikt.
E-mailverzending: plak geëxporteerde HTML in de e-mailtekst (gebruik bij voorkeur inline-stijlen).
Rijke tekst → Markdown: maak web-/CMS-richtekst schoon en breng deze over naar versiebeheerbare Markdown.
Technische documentatie: render formules en diagrammen en exporteer in één stap.
Editor-migratie: stem verschillen tussen Markdown-dialecten op elkaar af.
Wiki/kennisbank: zet HTML-pagina's om naar Markdown voor import.
API-changelog: zet HTML/beschrijvingen om naar Markdown voor review/PR's.

🎛️ Conversieparameters & rendering

Markdown → HTML rendert KaTeX/Mermaid automatisch.
HTML → Markdown behoudt/herstelt de bron; er wordt niet opnieuw gerenderd.
GFM (tabellen/taken) is standaard ingeschakeld; gebruik standaard Markdown-syntaxis voor strikt gedrag.
Zachte regeleinden zijn ingeschakeld; voor striktere controle gebruikt u lege regels of twee spaties aan het einde van de regel.
Zeer grote invoer kan een vereenvoudigde preview activeren (beperkte rendering/uitgeschakelde highlighting).

🧭 Gebruiksadvies

E-mail: gebruik bij voorkeur inline-stijlen voor betere compatibiliteit.
Lange documenten: converteer in delen om vertraging te voorkomen.

⚠️ Beperkingen & compatibiliteit

Dialectverschillen: rendering verschilt per platform; gebruik zoveel mogelijk generieke syntaxis.
HTML → Markdown is best effort: stijlen en lay-out gaan vaak deels verloren.
HTML → Markdown negeert bepaalde tags/attributen (scripts/styles/meta, embeds/forms, media, on*-events, style/class, enz.).
Complexe tabellen/nestingen kunnen versimpeld worden; controleer het resultaat.
Afbeeldingen/video's blijven externe links; ze worden niet gedownload.
Mermaid-SVG's die elders zijn gerenderd, kunnen meestal niet betrouwbaar worden terugvertaald.

🔒 Privacy & veiligheid

Alle verwerking gebeurt in uw browser; gegevens verlaten uw apparaat niet.
Voert geplakte <script>-tags niet uit.
KaTeX/Mermaid worden met veilige configuratie gerenderd.
HTML wordt niet automatisch volledig gesaneerd; controleer de inhoud vóór en na conversie zelf.

❓ Veelgestelde vragen

De preview wijkt af van het doelplatform — hoe onderzoek ik dat?

Achterhaal eerst het doeldialect (CommonMark/GFM/custom). Vermijd rauwe HTML en privé-extensies. Gebruik gestandaardiseerde regeleinden (lege regels of twee spaties aan het einde). Maak een minimaal voorbeeld, test dat op het doelplatform en breid dan uit.

Hoe zorg ik dat geëxporteerde HTML veilig in productie draait?

Deze tool voert geen <script> uit, maar voert ook geen volledige sanitisatie uit. Sanitize HTML in de server/pipeline met een whitelist-bibliotheek (zoals DOMPurify), blokkeer on*-handlers en gevaarlijke URI-schema's en dwing een CSP af voor externe/inline scripts.

HTML → Markdown vervormt complexe structuren — wat nu?

Gebruik meer draagbare semantiek: zet geneste tabellen/lijsten om in pijptabellen en vlakkere lijsten; plak inhoud eerst als platte tekst om span/style/class te verwijderen; isoleer een minimaal voorbeeld en pas de bron aan.

Wat zijn de beperkingen van KaTeX/Mermaid en hoe los ik problemen op?

Syntaxis: KaTeX met $$…$$ of inline $…$; Mermaid met ```mermaid-blokken. Grote invoer kan degradatie activeren (bron tonen/highlighting uit). Verlaag dichtheid, converteer in delen en gebruik minimale voorbeelden om syntaxisproblemen te lokaliseren. Herstel: KaTeX kan vanuit gerenderde HTML worden teruggeleid; Mermaid-herstel werkt alleen voor diagrammen die door deze tool zijn gegenereerd met ingesloten bron.