You can turn a PDF into LLM‑ready Markdown by uploading it to a service, by pasting its text into a chat, or by asking your agent to call a conversion engine on your own machine. The third route keeps headings, tables and lists as real Markdown and uploads nothing. With the GroupDocs.Conversion.Mcp server, Claude, Cursor or GitHub Copilot run it locally from one prompt:
Convert report.pdf to Markdown
The step‑by‑step version with config and troubleshooting is in the documentation: How to convert PDF to Markdown with an MCP server.
Warum bestimmt der Markdown‑Schritt die Qualität Ihres RAG‑Index?
Eine Retrieval‑Pipeline kann nur das indexieren, was der Konvertierungsschritt erhalten hat. Wenn eine Tabelle zu einer Reihe von Zahlen abgeflacht wird, kann ein Ausschnitt dieser Tabelle keine Frage beantworten. Wenn Überschriften verschwinden, hat ein Chunker keine Abschnittsgrenzen, die er respektieren kann. Die Dokumente, die Sie am meisten in einer privaten Wissensdatenbank haben möchten, sind oft genau die, die Sie am wenigsten an Dritte senden wollen: Verträge, interne Berichte, Patienten‑ oder Kundendaten. Die Wahl des Weges entscheidet daher gleichzeitig über zwei Dinge: wie viel Struktur erhalten bleibt und wohin die Datei reist.
Methode 1: Laden Sie das PDF zu einem Online‑Konverter oder einer Cloud‑Parsing‑API hoch?
Dies ist der schnellste Weg und zugleich der mit dem größten Kompromiss. Die Datei verlässt Ihren Rechner und wird auf einer Infrastruktur verarbeitet, die Sie nicht kontrollieren. Für öffentliche Dokumente kann das akzeptabel sein. Für vertrauliche Inhalte ist das der Schritt, bei dem eine Sicherheitsprüfung einstoppt.
Wählen Sie diesen Weg nur, wenn der Inhalt nicht sensibel ist und Sie einen Rundweg pro Datei über den Service eines Dritten akzeptieren.
Methode 2: Fügen Sie den PDF‑Text in den Chat ein und bitten das Modell, ihn zu formatieren?
Damit bleibt der Prozess auf Ihrer Seite des Tisches, aber das Modell schreibt den Inhalt jetzt um, anstatt ihn zu konvertieren. Es sieht nur den Text, der beim Einfügen extrahiert wurde. Tabellenrahmen, Spaltenreihenfolge und Seitengeometrie sind bereits weg, und das Modell füllt die Lücken durch Raten. Lange Dokumente stoßen zudem vor Erreichen der letzten Seite an das Kontextfenster.
Verwenden Sie diesen Ansatz für einen einzelnen Absatz, nicht für einen Ordner voller Berichte.
Methode 3: Lassen Sie Ihren Agenten eine lokale Konvertierungs‑Engine aufrufen?
Hier entscheidet der Agent und die Engine konvertiert. Der Agent sendet einen Dateinamen und ein Zielformat an das convert‑Tool, und die GroupDocs.Conversion‑Engine schreibt eine Markdown‑Datei neben Ihre Dokumente. Im Tool‑Aufruf ist das Format md:
{
"name": "convert",
"arguments": {
"file": { "filePath": "report.pdf" },
"format": "md"
}
}
Sie schreiben dieses JSON nie selbst. Sie tippen den Satz, und der Agent erzeugt den Aufruf. Die Struktur bleibt als echte Markdown‑Konstrukte erhalten: Überschriften werden zu # und ##, Tabellen zu Pipe‑Tabellen, Listen zu Listenelementen. Das ist das Format, das eine Embedding‑Pipeline und ein LLM nativ lesen, und Sie können die Datei direkt an Ihren Chunker weitergeben.
Die Form des Ergebnisses sieht so aus. Der nachfolgende Inhalt ist illustrativ, nicht das Ergebnis eines echten Laufs:
# Quartalsbericht
## Umsatz nach Region
| Region | Q1 | Q2 |
|---|---|---|
| Nord | 120 | 135 |
| Süd | 98 | 101 |
Komplexe Layouts sind dort, wo eine Engine, die für Dokumententreue gebaut wurde, sich von einem einfachen Text‑Extraktor unterscheidet. Ob das für Ihre Dokumente relevant ist, sollten Sie an Ihren drei schwierigsten PDFs testen, bevor Sie sich festlegen.
Wenn Markdown das einzige Ausgabeformat ist, das Sie benötigen, hat GroupDocs zudem einen dedizierten Server, GroupDocs.Markdown.Mcp. Die Dokumentation beschreibt ihn als Konverter von PDF, Word, Excel, EPUB und über 20 weiteren Formaten in sauberes, strukturiertes Markdown, mit Kontrolle über Seitenauswahl, Bilder und Front‑Matter. GroupDocs.Conversion.Mcp passt, wenn Markdown eines von vielen Zielformaten im selben Workflow ist. Der RAG‑fokussierte Vergleich findet sich in Your RAG pipeline starts with Markdown — keep that step local, und der Server ist dokumentiert unter docs.groupdocs.com/markdown/mcp.
Wie richten Sie den lokalen Pfad ein?
Registrieren Sie den Server einmal in Ihrem Client. Ein Claude‑Desktop‑Eintrag:
{
"mcpServers": {
"groupdocs-conversion": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Conversion.Mcp", "--yes"],
"env": { "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents" }
}
}
}
Dies benötigt das .NET 10 SDK. Der gleiche Server‑Eintrag funktioniert in Cursor, VS Code mit GitHub Copilot und Claude Code; die genaue Konfigurationsdatei für jeden Client ist im docs hub aufgelistet. Starten Sie den Client danach neu. Im Evaluations‑ oder Lizenz‑Datei‑Modus benötigt die Konvertierung kein Netzwerk, sobald das Paket heruntergeladen ist; die nutzungsbasierte Lizenz meldet die Nutzung und benötigt daher ausgehenden Zugriff.
Prompt‑Beispiele, die funktionieren:
Turn every PDF in this folder into Markdown for my knowledge base.
(Alle PDFs in diesem Ordner in Markdown für meine Wissensdatenbank umwandeln.)
Check how many pages whitepaper.pdf has, then convert it to Markdown.
(Prüfen, wie viele Seiten whitepaper.pdf hat, dann in Markdown konvertieren.)
Der zweite Prompt verknüpft get_document_info, das Dateityp, Seitenzahl und Grundinformationen zurückgibt, bevor convert ausgeführt wird.
Beispiel‑Sitzung
Dies ist eine gekürzte, illustrative Sitzung basierend auf den Tool‑Beschreibungen in der Dokumentation, kein Screenshot.
You: Check how many pages whitepaper.pdf has, then convert it to Markdown.
Agent: [calls get_document_info with file.filePath = "whitepaper.pdf"]
Agent: [calls convert with file.filePath = "whitepaper.pdf", format = "md"]
Agent: Done. The Markdown file is saved as whitepaper.md in your output folder.
Was sind die Grenzen?
- Scans benötigen zuerst OCR. Ein PDF, das nur aus Bildern besteht, hat keine Textebene, und OCR ist nicht Teil dieses Servers, sodass das Markdown seine Wörter nicht enthält. Führen Sie OCR vor der Konvertierung aus, wenn Ihre PDFs Scans sind.
- Evaluations‑Modus. Ohne Lizenz enthält die Ausgabe ein Evaluations‑Wasserzeichen und ein Server‑Prozess kann höchstens 15 Dokumente gleichzeitig öffnen. Rufen Sie
get_license_statusvor einer großen Ingestion auf, um zu bestätigen, welcher Modus aktiv ist. - Konvertierung, nicht Extraktion. Dieser Server konvertiert ein komplettes Dokument nach Markdown. Wenn Sie bestimmte Felder oder typisierte Werte extrahieren müssen, verwenden Sie GroupDocs.Parser.Mcp (nur als Docker‑Image verfügbar) und setzen beide ein, wenn eine Pipeline beides benötigt.
FAQ
Wie konvertiere ich PDF zu Markdown für RAG, ohne die Datei hochzuladen?
Betreiben Sie einen Konvertierungs‑Server auf Ihrer eigenen Maschine und lassen Sie Ihren Agenten ihn aufrufen. Mit GroupDocs.Conversion.Mcp schreibt das convert‑Tool die .md‑Datei in Ihren Ordner, und kein Dokument wird an einen Cloud‑Dienst gesendet.
Werden Tabellen erhalten, wenn ein PDF zu Markdown wird?
Ja, als Markdown‑Pipe‑Tabellen. Testen Sie zuerst Ihre komplexesten Tabellen, weil Layout‑Komplexität der Punkt ist, an dem Konverter sich unterscheiden.
Kann ich das Markdown später zurück zu PDF oder Word konvertieren?
Ja. Derselbe Server konvertiert Markdown zu PDF und DOCX, wie im the export post beschrieben.
Mehr erfahren
- Dokumentation, kanonische Anleitung: How to convert PDF to Markdown with an MCP server
- Dokumentations‑Hub: GroupDocs.Conversion MCP Server
- Einstieg: Why your AI agent should not convert documents by itself
- Verwandt: Automate report delivery: let the agent write Markdown and ship Word
- Verwandt: A whole folder, one prompt: batch conversion with Claude and MCP
- Ankündigung: Your AI Agent Can Now Convert Documents — Locally. Introducing GroupDocs.Conversion MCP
- On‑Premise‑ und Sicherheitsmodell: 3 architectures for AI document processing, and the one that keeps files inside your network
- Fragen: GroupDocs Conversion forum
- Quelle: GroupDocs.Conversion.Mcp on GitHub