MarkItDown
    GUIDE

    Markdown im Browser oder mit Python? Die ehrliche Entscheidung

    von Adriano CarusoLesezeit 6 Min.

    Wann reicht der Browser, wann brauchst du Python? Ein praktischer Vergleich mit Code-Beispielen, Performance-Daten und Entscheidungslogik für Entwickler und Nicht-Entwickler.

    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.

    VarianteKonvertierungszeitAufwand pro Datei
    Browser (markitdown.de)4 bis 6 Sekunden15 Sekunden inkl. Klicks
    Python lokal3 bis 5 Sekunden0 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

    MMarkItDown

    Dokumente als Markdown für Claude, ChatGPT und Gemini

    Navigation

    Basiert auf der Open-Source-Bibliothek MarkItDown von Microsoft. Dieses Tool ist ein unabhängiges Browser-Frontend und steht in keiner offiziellen Verbindung zu Microsoft.

    © 2026 Caruso Consulting UG (haftungsbeschränkt), Limburg an der Lahn

    Built by Caruso Consulting