PDFs in Markdown umwandeln: so sparst du Tokens

Wenn du PDFs einfach so in Claude ziehst, zahlst du das ganze Layout mit, Seite für Seite. Wie versprochen: die Anleitung zum Einrichten von MarkItDown, dem Gratis-Werkzeug von Microsoft. Es läuft lokal auf deinem Rechner und macht aus PDF, Word oder Excel sauberes Markdown.

Warum PDFs so viele Tokens kosten

Claude liest jede PDF-Seite doppelt. So beschreibt es Anthropic in der Doku zur PDF-Verarbeitung: Jede Seite wird in ein Bild umgewandelt, und der Text der Seite wird zusätzlich daneben mitgeliefert.

• Text: laut Anthropic typischerweise 1.500 bis 3.000 Tokens pro Seite, je nachdem, wie dicht sie beschrieben ist.
• Bild: Dazu kommen die Kosten für das Seitenbild, also Rahmen, Spalten, Kopfzeilen, Logos.

Bei einem dicken Vertrag oder Bericht sind das schnell zehntausende Tokens, und dein Limit ist weg. Markdown ist dagegen reiner Text mit ein paar Zeichen für Überschriften, Listen und Tabellen. Genau das Format, das Claude am liebsten liest. Ergebnis: deutlich weniger Tokens, und weil weniger Ballast im Kontext steckt, werden die Antworten oft sogar besser.

Was MarkItDown ist

Einrichten, Schritt für Schritt

Auf Windows öffnest du dafür PowerShell (Starttaste, „PowerShell“ tippen). Auf dem Mac das Terminal (Cmd + Leertaste, „Terminal“ tippen). Dann diese Befehle, einen nach dem anderen.

1. Python prüfen

   Kommt eine Versionsnummer ab 3.10, bist du mit diesem Schritt fertig.

   WindowsKopieren

   py --version

   MacKopieren

   python3 --version

   Kein Python oder eine ältere Version? Lade es von python.org/downloads. Auf Windows beim Installieren das Häkchen „Add python.exe to PATH“ setzen. Danach PowerShell bzw. Terminal einmal schließen und neu öffnen.

2. MarkItDown installieren

   Der Zusatz [all] holt die Bausteine für alle Dateitypen mit dazu.

   WindowsKopieren

   py -m pip install "markitdown[all]"

   MacKopieren

   python3 -m pip install "markitdown[all]"

   Meldet der Mac „externally-managed-environment“, nimm diesen Weg: brew install pipx, dann pipx install "markitdown[all]".

3. Deine erste Umwandlung

   Wechsle in den Ordner mit deiner PDF und wandle sie um. Heraus kommt eine Markdown-Datei mit gleichem Namen.

   Windows und MacKopieren

   cd Downloads
   markitdown vertrag.pdf -o vertrag.md

   Windows sagt „markitdown wurde nicht erkannt“? Dann geht derselbe Befehl so: py -m markitdown vertrag.pdf -o vertrag.md. Word und Excel funktionieren genauso, zum Beispiel markitdown bericht.docx -o bericht.md.

4. Einen ganzen Ordner auf einmal

   Wandelt alle PDFs im aktuellen Ordner um, jede in ihre eigene Markdown-Datei.

   Windows (PowerShell)Kopieren

   Get-ChildItem *.pdf | ForEach-Object { markitdown $_.FullName -o "$($_.BaseName).md" }

   Mac (Terminal)Kopieren

   for f in *.pdf; do markitdown "$f" -o "${f%.pdf}.md"; done

5. Kurz reinschauen

   Öffne die Markdown-Datei einmal mit einem Texteditor. Steht der Inhalt drin, passt alles. Ist sie fast leer, war die PDF ein Scan, also ein Foto von Text. Dann nimm für diese Datei das Original (siehe unten).

So gibst du Claude die Markdown-Datei

1. Claude-App

   Statt der PDF lädst du die .md-Datei in den Chat oder in das Projektwissen deines Projekts. Mehr ist es nicht.

2. Claude Code: einmal als Regel festlegen

   Claude Code kann MarkItDown auf deinem Rechner selbst aufrufen. Schreib diese Regel in deine CLAUDE.md, dann wandelt er Dateien künftig automatisch um, bevor er sie liest.

   Regel für die CLAUDE.mdKopieren

   ## PDFs und Office-Dateien
   Bevor du eine PDF-, Word-, PowerPoint- oder Excel-Datei liest, wandle sie mit MarkItDown in Markdown um:
   markitdown <datei> -o <datei>.md
   Lies danach nur die Markdown-Datei.
   Ausnahme: Geht es um Grafiken, Diagramme oder das Layout, oder ist die Markdown-Datei fast leer (Scan), nimm die Original-Datei und sag mir kurz, warum.

   Oder als einzelner Auftrag, wenn du die Regel nicht dauerhaft willst:

   PromptKopieren

   Wandle zuerst mit MarkItDown um, dann lies die Markdown-Datei: [Dateiname]
   Befehl: markitdown [Dateiname] -o [Dateiname].md
   Danach: [deine eigentliche Aufgabe, z. B. Fass mir die Kündigungsfristen und Zahlungsbedingungen zusammen.]

3. Optional: als MCP-Server in Claude Code

   Microsoft liefert MarkItDown auch als MCP-Server. Dann hat Claude ein eigenes Werkzeug zum Umwandeln. Für die meisten reicht die Regel oben, das hier ist für alle, die es lieber als festes Werkzeug haben wollen.

   Installieren und verbindenKopieren

   pip install markitdown-mcp
   claude mcp add --transport stdio markitdown -- markitdown-mcp

   Mit /mcp siehst du in Claude Code, ob er verbunden ist. Gut zu wissen: Der Server kann jede Datei lesen, auf die dein Benutzerkonto Zugriff hat. Richte ihn nur auf deinem eigenen Rechner ein.

Wann du weiter die Original-PDF nimmst

Nur bei Grafiken und Diagrammen gibst du Claude weiterhin die Original-PDF. Markdown ist Text, Bilder bleiben dabei auf der Strecke.

Teste es selbst: vorher, nachher

Nimm eine deiner eigenen PDFs, am besten einen längeren Vertrag oder Bericht. Am genauesten misst du das in Claude Code:

1. Neue Sitzung starten, Claude die PDF lesen lassen, dann /context eingeben und den Wert notieren.
2. Neue Sitzung starten, Claude die Markdown-Datei lesen lassen, wieder /context.
3. Beide Werte vergleichen. Stell in beiden Sitzungen dieselbe Frage zum Inhalt und vergleich auch die Antworten.

In der Claude-App gibt es keinen Token-Zähler pro Datei. Dort merkst du den Unterschied daran, wie lange dein Limit hält.

Quellen: Microsoft MarkItDown auf GitHub, MarkItDown-MCP, Anthropic-Doku: PDF support, Claude-Code-Doku: MCP. Stand Oktober 2026, Befehle und Menüs können sich ändern.

Neue Guides direkt per Mail