Markdown naar PDF omzetten (gratis, codeblokken & tabellen intact)

Markdown is waar dingen geschreven worden — README's, vergadernotities, specs, documentatie. PDF is waar dingen verstuurd worden: naar een klant die geen .md-bestand opent, naar een manager die een bijlage wil, naar een printer. De kloof tussen de twee is één conversie, en je zou geen pandoc plus LaTeX-distributie moeten hoeven installeren om hem over te steken.

De adder bij de meeste snelle routes is dat ze precies de delen verhaspelen waar technische documenten op leunen: codeblokken zakken in tot proportionele letters, pipe-tabellen printen als een muur van |-tekens, en geneste lijsten worden plat. Een converter is hier alleen nuttig als de code en de tabellen het overleven — dus dat is de lat waar deze gids alles langs legt.

Omzetten — stap voor stap

🔒 pdfty.com/en/tools/markdown-to-pdf

Wat er precies rendert

De converter ondersteunt standaard-Markdown plus de extensies die ertoe doen voor technisch schrijven:

• Koppen — hiërarchie in groottes, met subtiele lijnen onder H1 en H2
• Fenced codeblokken — monospace, lichtgrijze achtergrond, behouden inspringing, syntaxiskleuring voor gangbare talen
• Inline code — de vertrouwde grijze-chipstijl
• Tabellen — pipe-tabellen in GitHub-stijl worden omrande tabellen met een gearceerde koprij
• Citaten — linkerrand, gedempte tekst
• Lijsten — geordend, ongeordend, genest
• Links — blijven klikbare links in de PDF
• Afbeeldingen via URL — ![](https://…)-afbeeldingen worden opgehaald en ingesloten

De pagina wordt gezet op een comfortabele leesbreedte met royale marges — dichter bij "intern document dat af oogt" dan bij een kale browserafdruk.

Wat NIET rendert

Eerlijkheidssectie. Markdown kent dialecten, en deze tool implementeert standaard-Markdown + tabellen + fenced code, niet de volledige GitHub-smaak:

• Takenlijsten (- [ ] todo) printen als letterlijke haken, geen selectievakjes.
• Doorhalen (~~tekst~~) wordt niet omgezet — de tildes blijven staan.
• Lokale afbeeldingen (![](./diagrams/arch.png)) kunnen niet verschijnen: je uploadt één bestand, en de server kan niet bij bestanden die er op jouw schijf naast staan. Host de afbeelding op een URL of reken op een gat.
• Mermaid-/wiskundeblokken renderen als gewone codeblokken, geen diagrammen of vergelijkingen.
• Geen eigen thema's — één ingebouwde stylesheet, geen CSS-upload.

Gratis lokale alternatieven

pandoc — dé canonieke converter: pandoc README.md -o readme.pdf. Voortreffelijke output en eindeloos configureerbaar, maar PDF-output vereist een LaTeX-engine (vaak een installatie van 1–4 GB). De moeite waard als je wekelijks documenten converteert; absurd voor één README.

VS Code-extensies (bijv. "Markdown PDF") — handig als je toch al in VS Code leeft; de outputkwaliteit wisselt per extensie en thema.

Browservoorbeeld + printen: render de Markdown waar hij maar een voorbeeld krijgt (veel editors kunnen een HTML-preview serveren), dan Ctrl/Cmd+P → Opslaan als PDF. Gratis en lokaal, maar je erft de printeigenaardigheden van de browser: URL-kop- en voetteksten tenzij je ze uitschakelt, en pagina-einden die midden in een codeblok landen.

macOS: geen ingebouwde Markdown-renderer — Voorvertoning en Teksteditor behandelen .md als platte tekst, dus je ziet de rauwe hekjes en sterretjes.

Praktische valkuilen

• Pagina-einden zijn automatisch. Lange codeblokken kunnen over pagina's splitsen. Er is geen handmatige pagina-eindemarkering; de engine breekt waar nodig.
• Heel brede tabellen en lange coderegels worden geschaald of afgekapt op de inhoudsbreedte — een tabelrij van 200 tekens past niet sierlijk op een staande pagina. Kort regels in waar het kan.
• Front matter (----YAML bovenaan het bestand) wordt behandeld als inhoud, niet verborgen — verwijder het vóór het converteren als je het niet geprint wilt. (Een ----blok helemaal bovenaan kan ook renderen als horizontale lijn plus tekst, afhankelijk van de opmaak.)
• Emoji-shortcodes zoals :rocket: blijven letterlijk; echte geplakte emoji-tekens renderen doorgaans wel.
• Check linkdoelen. Relatieve links ([docs](./docs/setup.md)) overleven als links maar wijzen nergens zinnigs heen zodra het geprint is.

Zodra de PDF bestaat, geldt de gebruikelijke gereedschapskist: stempel hem met Kop- & voettekst voor paginatellers, combineer hoofdstukken met Samenvoegen, of verklein een afbeeldingsrijke met Comprimeren.

Veelgestelde vragen

Behouden codeblokken hun syntaxiskleuring?

Ja — fenced blokken met een taalhint (```python) krijgen kleurmarkering; zonder hint zijn ze gewoon monospace op grijs. Hoe dan ook blijft de inspringing exact behouden.

Renderen tabellen echt als tabellen?

Ja — pipe-tabellen (de GitHub-stijl) worden omrande tabellen met een gearceerde koprij. Uitlijnings-dubbelepunten worden door de parser gerespecteerd.

Waarom ontbreekt mijn afbeelding in de PDF?

Hij wordt via een lokaal pad gerefereerd. De upload is één .md-bestand, dus ./images/x.png wijst nergens heen. Gebruik een volledige https://-URL, of converteer lokaal met pandoc waar relatieve paden wél oplossen.

Kan ik een README rechtstreeks van GitHub omzetten?

Download eerst het rauwe .md-bestand en upload dat. Badges en afbeeldingen op volledige URL's komen meestal door; GitHub-exclusieve functies (takenlijsten, mermaid) niet — zie de lijst hierboven.

Kan ik fonts, marges of kleuren aanpassen?

Niet in deze tool — hij levert één bewust schone stylesheet. Voor een gebrand ontwerp ga je via HTML naar PDF met je eigen CSS.

Is er een grootte- of paginalimiet?

Gratis: 20 MB per bestand en 10 bewerkingen per dag — voor tekstbestanden effectief geen limiet. Output-PDF's van meer dan 50 pagina's genereren prima vanuit één Markdown-bron.

Is mijn document privé?

De overdracht gaat via HTTPS en bestanden worden binnen 1 uur automatisch verwijderd. Voor vertrouwelijk materiaal dat je niet mag uploaden is pandoc de lokale route.

Kan ik de andere kant op — PDF naar Markdown?

Niet rechtstreeks. Het dichtstbij komt Tekst extraheren (platte tekst, geen opmaak) of PDF naar Word, en vanaf daar opschonen.