Markdown is ideaal om in te schrijven, maar de mensen naar wie je een document stuurt, verwachten vaak een webpagina of een pdf. Het goede nieuws: Markdown omzetten is eenvoudig, en in de meeste gevallen heb je geen ingewikkelde toolchain nodig.
Hieronder vind je vier manieren, van de snelste tot de meest configureerbare, en een reeks tips waarmee het resultaat er professioneel uitziet.
Snelle vergelijking
| Methode | HTML | Installatie | Het meest geschikt voor | |
|---|---|---|---|---|
| Export uit een browsereditor | ✅ | ✅ (afdrukken) | Niets | Dagelijkse documenten, snel delen |
| VS Code + extensie | ✅ | ✅ | Editor + extensie | Wie al in VS Code schrijft |
| Pandoc | ✅ | ✅ | Pandoc (+ een pdf-engine) | Boeken, papers, geautomatiseerde pipelines |
| Een script (markdown-it, marked) | ✅ | — | Node.js | Eigen websites en buildstappen |
1. Exporteren vanuit een editor in de browser
De snelste route is een editor die direct exporteert. Open of plak je document in Markdown Preview Editor — in de online versie of je eigen exemplaar — en gebruik de knoppen in de kopbalk:
- HTML maakt één zelfstandig
.html-bestand. Stijlen, codemarkering, formules, diagrammen en afbeeldingen die je samen met het document hebt geopend, worden ingesloten. Zo ziet het bestand er op elke computer goed uit en kun je het zonder aanpassingen als bijlage mailen of ergens uploaden. - Afdrukken opent het afdrukvenster van de browser. Kies Opslaan als pdf als bestemming om een pdf te krijgen. Alleen het weergegeven document wordt afgedrukt — geen werkbalk, geen editor.
- Opslaan downloadt de Markdown-bron als
.md-bestand.
Omdat alles in de browser gebeurt, werkt dit ook voor documenten die je liever niet naar een online converter uploadt.
Een nette pdf uit het afdrukvenster
- Zet Marges op Standaard of Minimum, afhankelijk van hoeveel tekst je per pagina wilt.
- Zet Kop- en voetteksten uit om de datum en de URL van de paginaranden te halen.
- Zet Achtergrondafbeeldingen aan als je achtergronden van codeblokken en gestreepte tabellen wilt.
- Gebruik een licht thema om af te drukken — dat bespaart inkt en leest prettiger op papier.
2. VS Code met een extensie
VS Code heeft een ingebouwde Markdown-preview, maar geen exportknop. Extensies zoals Markdown PDF of Markdown Preview Enhanced voegen opdrachten toe om naar HTML en pdf te exporteren. Handig als VS Code al je editor is; de opmaak van het resultaat hangt af van de extensie, en sommige downloaden bij het eerste gebruik een headless browser.
3. Pandoc — de universele converter
Pandoc zet tientallen formaten in elkaar om en is de standaardtool voor boeken, wetenschappelijke artikelen en geautomatiseerde documentatie. Na de installatie is omzetten één opdracht:
bash# Markdown naar een volledige HTML-pagina
pandoc report.md -o report.html --standalone --metadata title="Report"
# Markdown naar pdf (vereist een pdf-engine, bijv. een LaTeX-distributie)
pandoc report.md -o report.pdf --pdf-engine=xelatex
# Markdown naar Word, als iemand erop staat
pandoc report.md -o report.docx
Zonder --standalone levert Pandoc alleen een HTML-fragment op — handig als je het in een bestaande pagina invoegt. Voor pdf-uitvoer is een aparte engine nodig: een LaTeX-distributie of een op HTML gebaseerde engine zoals WeasyPrint. De kracht van Pandoc is controle: sjablonen, bronvermeldingen, genummerde secties en kruisverwijzingen.
4. Een paar regels JavaScript
Is Markdown onderdeel van je eigen website of buildproces, dan is een bibliotheek de flexibelste optie. Met markdown-it:
jsimport MarkdownIt from 'markdown-it';
import { readFileSync, writeFileSync } from 'node:fs';
const md = new MarkdownIt({ linkify: true, typographer: true });
const body = md.render(readFileSync('README.md', 'utf8'));
writeFileSync('README.html', `<!doctype html><meta charset="utf-8"><title>README</title>${body}`);
Plug-ins voegen voetnoten, takenlijsten, formules en meer toe. Onthoud dat de uitvoer maar zo veilig is als de invoer: komt de Markdown van anderen, schoon de HTML dan op (bijvoorbeeld met DOMPurify) voordat je hem publiceert.
Tips voor betere HTML- en pdf-uitvoer
Begin met één duidelijke titel
Converters halen de documenttitel uit de bestandsnaam, de eerste kop of expliciete metadata. Geef elk document een beschrijvende bestandsnaam en één #-kop, dan zijn de geëxporteerde HTML en pdf makkelijk te herkennen in een downloadmap of browsertabblad.
Houd afbeeldingen bij het document
Gebruik relatieve paden zoals images/chart.png en bewaar de bestanden in dezelfde map. Als je de hele map in Markdown Preview Editor opent, worden de afbeeldingen gevonden en in de HTML-export ingesloten. Externe afbeeldingen die niet in het voorbeeld zijn geladen, worden ook niet ingesloten.
Bepaal zelf de pagina-einden
Markdown heeft geen syntaxis voor pagina-einden. Begin in documenten die je afdrukt grote secties met een ##-kop en houd tabellen kort — browsers vermijden het splitsen van tabelrijen, maar een enorme tabel loopt toch door op de volgende pagina. In tools die ruwe HTML en inline stijlen toestaan, zoals Pandoc, kun je <div style="page-break-after: always"></div> invoegen.
Controleer formules en diagrammen vóór het exporteren
Formules en diagrammen worden in de meeste tools door JavaScript-bibliotheken weergegeven. Controleer ze eerst in het voorbeeld — zie onze handleidingen over wiskundige formules in Markdown en Mermaid-diagrammen. In de HTML-export van Markdown Preview Editor worden ze opgeslagen als kant-en-klare opmaak en afbeeldingen, zodat het geëxporteerde bestand geen scripts nodig heeft.
Kies het thema bewust
Donkere HTML-exports zijn prettig op een scherm, maar een slechte keuze voor papier. Exporteer voor het medium dat de lezer gebruikt.
Veelgestelde vragen
Hoe zet ik Markdown gratis om naar pdf?
Open het document in een Markdown-viewer zoals Markdown Preview Editor, klik op Afdrukken en kies Opslaan als pdf in het afdrukvenster. Voor geautomatiseerde uitvoer of uitvoer in boekvorm gebruik je de gratis opdrachtregeltool Pandoc.
Hoe zet ik Markdown om naar HTML zonder iets te installeren?
Gebruik een editor in de browser met HTML-export. Markdown Preview Editor maakt een zelfstandig HTML-bestand inclusief stijlen, rechtstreeks in je browser.
Worden afbeeldingen opgenomen in de geëxporteerde HTML?
Lokale afbeeldingen die je samen met het document hebt geopend, worden in het HTML-bestand ingesloten, zodat het op zichzelf werkt. Afbeeldingen die op externe servers blijven staan, worden niet ingesloten.
Kan ik Markdown omzetten naar Word (DOCX)?
Ja, met Pandoc: pandoc input.md -o output.docx. Je kunt ook naar HTML exporteren en dat in Word openen; de meeste opmaak blijft dan behouden.