Markdown omzetten in de browser of met Python?

Steeds meer mensen zetten documenten om naar Markdown, meestal om ze aan ChatGPT, Claude of een eigen AI-toepassing te geven. Er zijn grofweg twee routes. Je gebruikt een tool die in je browser draait, of je schrijft een kort Python-script met een bibliotheek zoals MarkItDown. Beide werken. De vraag is welke bij jouw situatie past.

Twee routes, kort uitgelegd

In de browser open je een website, sleep je een bestand in een vak en krijg je Markdown terug. Bij een goede tool gebeurt de omzetting met JavaScript op je eigen apparaat. Je bestand gaat dus niet naar een server. Je hoeft niets te installeren en het werkt op Windows, Mac, Linux en vaak ook op een tablet.

Met Python installeer je eerst Python en een bibliotheek, bijvoorbeeld met pip install 'markitdown[all]'. Daarna schrijf je een paar regels code die bestanden inlezen en het resultaat opslaan. Je kunt dat script herhalen, uitbreiden en automatisch laten draaien.

De afweging op vijf punten

1. Gemak

De browser wint ruim. Je bent in seconden bezig, en een collega zonder technische achtergrond kan het ook. Python vraagt om een installatie, een terminal en een beetje kennis van paden en virtuele omgevingen. Voor een ontwikkelaar is dat een kwartiertje, voor een HR-adviseur een middag frustratie.

2. Privacy

Hier zit een veelvoorkomend misverstand. Een Python-script op je eigen laptop is privé: er gaat niets naar buiten, tenzij je dat zelf programmeert. Een browsertool kan net zo privé zijn, maar alleen als de omzetting echt in de browser gebeurt. Veel online converters uploaden je bestand naar hun server. Bij een offerte, een personeelsdossier of een medisch verslag is dat onder de AVG niet zomaar oké.

MarkItDown.nl zet bestanden om in je browser. Je kunt dat zelf controleren: open de ontwikkelaarstools van je browser, kijk bij het tabblad Netwerk en zet een bestand om. Je ziet dan geen upload van je document.

3. Schaal

Python wint zodra het om veel bestanden gaat. Een script dat een map met tweehonderd jaarverslagen omzet, draait gewoon door terwijl jij koffie haalt:

from pathlib import Path
from markitdown import MarkItDown

md = MarkItDown()
for pdf in Path("jaarverslagen").glob("*.pdf"):
    pdf.with_suffix(".md").write_text(md.convert(str(pdf)).text_content, encoding="utf-8")

In de browser kun je ook meerdere bestanden tegelijk omzetten en als ZIP downloaden. Voor tien of twintig bestanden is dat prima. Voor duizend wordt het onhandig.

4. Automatisering

Wil je dat nieuwe documenten elke nacht automatisch worden omgezet en in een zoekindex belanden, dan heb je een script nodig. Een browser kan dat niet zelfstandig. Dit is de belangrijkste reden voor bedrijven om voor Python te kiezen, bijvoorbeeld bij het bouwen van een RAG-toepassing met slim opgedeelde Markdown.

5. Kwaliteit

Over kwaliteit valt geen algemeen oordeel te geven. Beide routes gebruiken bibliotheken om PDF's, Word-bestanden en spreadsheets uit te lezen, en de uitkomst hangt sterk af van het document. Een eenvoudige brief gaat overal goed. Een PDF met drie kolommen, tabellen en voetnoten kan per tool heel verschillend uitpakken. Het enige betrouwbare advies: test met je eigen documenten. Een groot voordeel van een browsertool is dat je het resultaat direct naast elkaar ziet, als voorbeeld en als ruwe Markdown.

Overzicht

Welke route past bij jou?

Kies de browser als:

• je af en toe een document klaarmaakt voor ChatGPT of Claude;
• je geen software mag of wilt installeren op je werklaptop;
• je het resultaat meteen wilt controleren en aanpassen;
• je ook de andere kant op wilt, bijvoorbeeld een AI-antwoord via Markdown naar PDF als document opslaan.

Voorbeeld: een beleidsmedewerker bij een provincie zet een notitie van veertig pagina's om met Word naar Markdown, plakt het resultaat in Claude en vraagt om een samenvatting voor het college.

Kies Python als:

• je regelmatig tientallen of honderden bestanden verwerkt;
• het omzetten onderdeel is van een groter proces, zoals een kennisbank of zoekfunctie;
• je de uitvoer wilt nabewerken met eigen regels, bijvoorbeeld vaste disclaimers weghalen;
• er een ontwikkelaar in je team is die het script kan onderhouden.

Voorbeeld: een logistiek bedrijf in Venlo wil alle werkinstructies doorzoekbaar maken voor een interne chatbot en laat elke nacht nieuwe PDF's omzetten.

De slimme combinatie

Je hoeft niet te kiezen voor altijd. Een goede werkwijze is: begin in de browser met een handvol representatieve documenten. Kijk wat er goed gaat en wat niet. Zijn tabellen het probleem, of scans, of kolommen? Pas daarna besluit je of een script de moeite waard is, en weet je ook waar dat script op moet letten. Zo voorkom je dat je een pipeline bouwt voor documenten die toch handwerk nodig hebben.

Waar je op let bij een browsertool

Niet elke site die 'online converter' heet, werkt hetzelfde. Let op drie dingen. Ten eerste: vraagt de site om een account of e-mailadres, dan is dat voor een simpele omzetting een rood signaal. Ten tweede: duurt het omzetten opvallend lang en zie je een uploadbalk, dan gaat je bestand waarschijnlijk naar een server. Ten derde: lees de privacyverklaring. Staat daar dat bestanden 'na een uur worden verwijderd', dan zijn ze dus wel geüpload.

Een voorbeeld uit de praktijk

Neem een administratiekantoor in Apeldoorn. Een medewerker krijgt elke week een handvol PDF's van klanten en wil die samenvatten met ChatGPT. Ze heeft geen Python geïnstalleerd en wil dat ook niet. Voor haar is de browser de logische keuze: bestand erin, Markdown eruit, kopiëren en klaar. Omdat de omzetting lokaal draait, verlaten de klantgegevens haar laptop niet tot ze zelf besluit wat ze in de chatbot plakt.

Hetzelfde kantoor heeft ook een ontwikkelaar. Hij bouwt een interne zoekfunctie over vijf jaar aan archief: duizenden Word- en Excel-bestanden op een netwerkschijf. Dat ga je niet één voor één in een browser slepen. Hij schrijft een script met MarkItDown dat elke nacht nieuwe bestanden omzet en in een map zet die zijn zoekindex bijwerkt.

Beide routes leveren Markdown op, dus je kunt ze prima naast elkaar gebruiken. Wil je de browserroute proberen, begin dan met PDF naar Markdown of Word naar Markdown. Wil je het resultaat later weer als document hebben, dan zet je het terug met Markdown naar Word.

Kosten en onderhoud

Beide routes zijn gratis. De echte kosten zitten in tijd. Een browsertool hoeft niemand bij te houden. Een Python-script wel: bibliotheken krijgen updates, en een script dat vandaag werkt, moet je over een jaar misschien aanpassen. Reken dat mee als je voor een team kiest.

Samengevat

Voor gemak, controle en af en toe een bestand is de browser de snelste route, zolang de tool echt lokaal werkt. Voor grote aantallen, automatisering en integratie in je eigen systemen is Python de juiste keuze. Kwaliteit hangt vooral af van je documenten, dus test altijd eerst met een paar echte bestanden. Meer over de verschillende Python-tools lees je in MarkItDown vs Pandoc vs Markdownify.