MarkItDown gibt es in zwei Varianten: als Python-Library zum Installieren und als Browser-Tool unter markitdown.de. Beide nutzen denselben Konvertierungs-Code, doch wann lohnt sich was? Diese Frage hängt weniger von technischen Fähigkeiten ab als vom konkreten Anwendungsfall. Dieser Guide hilft dir, ehrlich zu entscheiden.
Die zwei Varianten im Überblick
Browser-Variante (markitdown.de). Du öffnest die Webseite, ziehst eine Datei rein, kopierst das Markdown raus. Keine Installation, keine Konfiguration. Die Konvertierung läuft komplett lokal in deinem Browser via WebAssembly, deine Daten verlassen nie den Rechner.
Python-Library (markitdown via pip). Du installierst die Library mit pip install markitdown und nutzt sie in eigenen Scripts oder als Command-Line-Tool. Voll skriptbar, automatisierbar, in Workflows einbindbar. Setzt Python-Grundkenntnisse voraus.
Beide Varianten produzieren identisches Markdown, weil sie dieselbe Konvertierungs-Logik nutzen. Der Unterschied liegt in Bedienkomfort, Skalierung und Integration.
Wann der Browser reicht
Für die große Mehrheit der Anwendungsfälle ist die Browser-Variante die bessere Wahl. Konkret in diesen Situationen:
Einmalige oder gelegentliche Konvertierungen. Du musst alle paar Tage mal eine PDF in Markdown verwandeln, um sie an Claude oder ChatGPT zu schicken. Browser auf, Datei rein, fertig.
Du bist kein Entwickler. Wenn dir pip install schon zu viel ist, ist der Browser die einzige sinnvolle Variante. Kein Setup, keine Abhängigkeiten.
Du arbeitest mit sensiblen Daten und willst Sicherheit. Die Browser-Variante läuft komplett lokal, keine Datei verlässt deinen Rechner. Das ist nachweisbar im Browser-Network-Tab. Manche denken, lokales Python wäre sicherer, aber Browser-WebAssembly bietet dieselbe Garantie ohne Setup.
Du wechselst Geräte häufig. Die Browser-Variante funktioniert auf jedem Rechner, jedem Tablet, jedem Betriebssystem. Du musst nicht jedes Mal Python installieren.
Du brauchst keine Automatisierung. Solange du jede Datei einzeln per Hand konvertierst, ist der Browser schneller als jedes Script. Aufgabe öffnen, Datei reinziehen, kopieren, Browser schließen. 30 Sekunden.
Wenn du fünf oder weniger Dateien pro Woche konvertierst, ist die Browser-Variante in 90 Prozent der Fälle die richtige Wahl. Erst ab regelmäßig zweistelligen Konvertierungen pro Woche lohnt sich der Setup-Aufwand für Python.
Wann Python sich lohnt
Es gibt klare Fälle, in denen die Python-Library die deutlich bessere Wahl ist:
Massenkonvertierungen. Du hast einen Ordner mit 200 PDFs, die alle ins Markdown sollen. Im Browser müsstest du das einzeln machen. Mit Python ist das ein 10-Zeilen-Script.
Automatisierte Workflows. Eine neue Datei landet in einem Watch-Folder, soll automatisch konvertiert und in eine Knowledge Base eingespeist werden. Das geht nur skriptbar.
Integration in eigene Tools. Du baust eine Webapp, die User-Uploads konvertieren soll. Oder einen Slack-Bot, der angehängte PDFs automatisch zusammenfasst. Library statt UI.
Pre-Processing für RAG-Pipelines. Du baust ein Retrieval-Augmented-Generation-System und brauchst Konvertierung als Schritt zwischen Upload und Vector-Embedding. Python lässt sich nahtlos in LangChain, LlamaIndex oder eigene Pipelines integrieren.
CI/CD-Integration. Dokumentation wird bei jedem Commit automatisch aus Office-Quellen in Markdown generiert. Browser-Tool funktioniert dort nicht, Python schon.
Spezifische Konfiguration. Du brauchst eigene Pre- oder Post-Processing-Schritte, eigene Plugins, eigene Output-Anpassungen. Die Library ist erweiterbar, der Browser nicht.
Praktische Code-Beispiele
Hier zwei minimale Beispiele, damit du eine Vorstellung vom Python-Setup bekommst.
Beispiel eins: einmalige Konvertierung einer Datei
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert("dokument.pdf")
print(result.text_content)
Vier Zeilen Code, fertig. Output ist Markdown-Text als String, kannst du speichern oder weiterverarbeiten.
Beispiel zwei: Batch-Konvertierung eines ganzen Ordners
from markitdown import MarkItDown
from pathlib import Path
md = MarkItDown()
input_dir = Path("dokumente")
output_dir = Path("markdown")
output_dir.mkdir(exist_ok=True)
for file in input_dir.iterdir():
if file.suffix.lower() in [".pdf", ".docx", ".xlsx", ".pptx"]:
result = md.convert(str(file))
output_file = output_dir / (file.stem + ".md")
output_file.write_text(result.text_content)
print(f"Konvertiert: {file.name}")
Mit diesem Script konvertierst du einen ganzen Ordner in unter zehn Sekunden, vorausgesetzt die Dateien sind nicht riesig. Browser-Konvertierung der gleichen Menge würde mehrere Minuten manuelle Klicks bedeuten.
Die Python-Library braucht Python 3.10 oder neuer. Installation läuft über pip install markitdown. Für PDF-OCR wird zusätzlich Tesseract benötigt, das du über deinen Paketmanager (apt, brew, choco) installierst.
Performance-Vergleich aus der Praxis
Ein echtes Beispiel mit identischem Input: eine 8-MB-PDF mit 45 Seiten, gemischter Inhalt aus Text, Tabellen und einigen Bildern.
| Variante | Konvertierungszeit | Aufwand pro Datei |
|---|---|---|
| Browser (markitdown.de) | 4 bis 6 Sekunden | 15 Sekunden inkl. Klicks |
| Python lokal | 3 bis 5 Sekunden | 0 Sekunden (im Script) |
Die reine Konvertierungszeit ist ähnlich, weil beide Varianten dieselbe Library nutzen. Der Unterschied entsteht durch den manuellen Aufwand pro Datei. Bei einer einzelnen Datei spielt das keine Rolle. Bei 50 Dateien sind das im Browser 12 Minuten Klick-Arbeit, in Python 0 Minuten.
Entscheidungs-Matrix
Beantworte für dich diese drei Fragen:
Anzahl der Konvertierungen pro Monat:
- 1 bis 20: Browser
- 21 bis 100: Browser oder Python (je nach den anderen Punkten)
- 100+: Python
Technische Komfortzone:
- Python ist Fremdsprache: Browser
- Python-Basics vorhanden: Beide möglich
- Python wird täglich genutzt: Python
Anwendungsfall:
- Manuell, einmalig, lokale Aufgabe: Browser
- Automatisierung, Pipeline, Integration: Python
- Gelegentliche Konvertierungen am Arbeitsrechner: Browser
Wenn mindestens zwei der drei Antworten "Browser" sind, ist die Browser-Variante richtig. Wenn mindestens zwei "Python" sind, lohnt sich der Setup-Aufwand.
Viele Power-User nutzen beides parallel. Browser für schnelle einmalige Konvertierungen am Laptop, Python im Backend für automatisierte Workflows. Das schließt sich nicht aus.
Häufige Missverständnisse
Missverständnis eins, "Python ist immer schneller als Browser." Bei einer einzelnen Datei sind beide ähnlich schnell. Python wird erst bei Batch-Operationen wirklich überlegen.
Missverständnis zwei, "Im Browser werden meine Daten hochgeladen." Falsch bei markitdown.de. Die Konvertierung läuft komplett lokal via WebAssembly. Du kannst das im Browser-Network-Tab verifizieren, dort gibt es keine Upload-Requests während der Konvertierung.
Missverständnis drei, "Python kann mehr Formate als der Browser." Nein, beide Varianten unterstützen dieselben Formate, weil sie dieselbe Library nutzen. PDF, DOCX, XLSX, PPTX, Bilder, HTML und mehr funktionieren in beiden gleich.
Missverständnis vier, "Browser-Variante ist nur für Einsteiger." Auch erfahrene Entwickler nutzen den Browser für schnelle ad-hoc-Konvertierungen. Ein Tab öffnen ist oft schneller als ein Terminal aufzumachen und ein Script anzustoßen.
Wann beides sich ergänzt
Ein typisches hybrides Setup aus der Praxis:
Du nutzt im Alltag die Browser-Variante für alles, was spontan kommt. Eine PDF, die ein Kollege geschickt hat. Eine Excel-Tabelle aus einem Meeting. Schnelle Konvertierung, fertig.
Parallel hast du im Backend deines Hauptprojekts (zum Beispiel ein RAG-System für eine Wissensdatenbank) die Python-Library integriert. Sobald ein User ein Dokument hochlädt, wird es serverseitig konvertiert und in den Vector Store eingespeist.
Beide Welten profitieren voneinander, weil die Konvertierungs-Logik identisch ist und du keine Inkonsistenzen bekommst.
Fazit
Die Browser-Variante ist für 80 Prozent der LLM-Nutzer die richtige Wahl, weil sie ohne Setup funktioniert und für gelegentliche Konvertierungen ideal ist. Python lohnt sich, sobald du regelmäßig automatisierst, integrierst oder skripten willst. Beide Varianten sind kostenlos, beide nutzen dieselbe Microsoft-Library, beide produzieren identisches Markdown. Die Wahl hängt nur an deinem Workflow, nicht an der Qualität.
Wenn du gerade anfängst und unsicher bist: starte mit dem Browser-Tool. Wenn du nach drei Wochen merkst, dass du täglich konvertierst, lohnt sich der Wechsel zu Python.
Weiterführend
- MarkItDown direkt nutzen für sofortige Browser-Konvertierung
- Was ist Markdown?, für die Grundlagen
- MarkItDown vs Pandoc vs Markdownify, wenn du andere Tools in Betracht ziehst
- Claude Projects mit Dokumenten füttern, für den nächsten Schritt nach der Konvertierung