MarkItDown als API

MarkItDown wandelt Dokumente in Markdown für Sprachmodelle und Text-Pipelines um. Es übernimmt Überschriften, Listen, Tabellen und Links aus Word-, PowerPoint-, Excel- und HTML-Dateien und liest die Textebene eines PDFs. MarkItDown ist ein Open-Source-Projekt von Microsoft.

Hier läuft es als API: Senden Sie eine Datei an POST /v1/markitdown/convert, und das Markdown kommt in der Antwort zurück. Die Datei wird im Arbeitsspeicher umgewandelt und nicht gespeichert.

Preis und Limits

• Mit API-Schlüssel kostet eine Umwandlung 1 Credit. Ein abgelehnter oder fehlgeschlagener Aufruf kostet nichts.
• Ohne Schlüssel läuft der Aufruf mit dem anonymen Rate-Limit und dem kostenlosen Tageskontingent Ihrer Internetadresse.
• Eine Datei pro Aufruf, bis 8 MB. Eine Umwandlung, die länger als 30 Sekunden dauert, wird abgebrochen.
• Der Content-Type der Datei bestimmt, wie sie gelesen wird: application/pdf, die Office-Typen von .docx, .pptx und .xlsx, text/html oder text/plain.
• PDFs kommen als Text ihrer Textebene zurück, ohne Überschriften und ohne OCR. Für Scans nutzen Sie zuerst OCRmyPDF oder wandeln mit Docling um.

Tarife und Credit-Guthaben stehen auf der Preisseite. Ein Guthaben bezahlt jede Engine.

Selbst hosten oder die gehostete API

MarkItDown ist eine Python-Bibliothek und ein Kommandozeilenwerkzeug. Um es selbst zu hosten, brauchen Sie Python 3.10 oder neuer, pip install 'markitdown[docx,pptx,xlsx,pdf]' und einen eigenen Webdienst darum. Führen Sie jede Umwandlung in einem eigenen Prozess mit Zeitlimit aus, sonst blockiert ein langsames Dokument den Dienst. Jeder warme Worker-Prozess belegt etwa 200 MB Arbeitsspeicher.

Die gehostete API ist ein API-Schlüssel: kein Server zu betreiben, die Umwandlung in beendbaren Worker-Prozessen mit 30-Sekunden-Limit, ein MCP-Server für KI-Assistenten und derselbe Schlüssel und dasselbe Credit-Guthaben für die anderen Engines.

curl

curl -H "X-API-Key: YOUR_KEY" \
  -F "file=@report.docx;type=application/vnd.openxmlformats-officedocument.wordprocessingml.document" \
  https://api.pagespool.com/v1/markitdown/convert

Die Antwort ist JSON. Das Markdown steht in markdown:

{"markdown": "# Quarterly report\n\nRevenue grew 8 percent in EMEA.\n\n...", "meta": {"filename": "report.docx"}}

Python

import httpx

with open("report.pdf", "rb") as fh:
    resp = httpx.post(
        "https://api.pagespool.com/v1/markitdown/convert",
        files={"file": ("report.pdf", fh, "application/pdf")},
        headers={"X-API-Key": "YOUR_KEY"},
        timeout=60,
    )
resp.raise_for_status()
print(resp.json()["markdown"])

Jeder Fehler ist ein Problem-Dokument (RFC 9457) mit einem code: payload_too_large (413), unsupported_media_type (415), conversion_failed (422), engine_busy (429, mit Retry-After) oder engine_timeout (504).

Den API-Schlüssel senden

Die API nimmt den Schlüssel in einer von drei Formen an:

• im Header X-API-Key: YOUR_KEY;
• im Header Authorization: Bearer YOUR_KEY;
• per HTTP-Basic-Authentifizierung mit dem Schlüssel als Passwort und einem beliebigen Benutzernamen, wie in curl -u x:YOUR_KEY. Ein Client, der nur eine Basis-URL annimmt, gibt den Schlüssel genauso mit, als https://x:YOUR_KEY@ vor dem Host von https://api.pagespool.com. httpx und axios senden das als Basic-Authentifizierung.

Setzen Sie den Schlüssel nie in den Pfad oder den Query-String: Beide landen in Zugriffsprotokollen.

MCP-Server

KI-Assistenten erreichen MarkItDown unter https://api.pagespool.com/mcp/markitdown/. Sein Tool convert_document nimmt die Datei als Base64 oder als Download-Link an, mit denselben Formaten, Limits und Preisen wie die API. Die Verbindungsseite zeigt die Schritte für jeden Client.

Kostenlose Tools

Testen Sie die Umwandlung im Browser, ohne Konto: HTML zu Markdown für eingefügtes HTML bis 100 KB und Word zu Markdown für eine .docx-Datei bis 4 MB.

MarkItDown ist ein Open-Source-Projekt von Microsoft. MarkItDown ist eine Marke ihres Inhabers; pagespool ist mit ihm nicht verbunden.

FAQ

Kann MarkItDown gescannte PDFs lesen?

Nein. Es liest die Textebene eines PDFs, deshalb kommt ein Scan leer zurück. Schicken Sie den Scan zuerst durch OCRmyPDF, oder wandeln Sie ihn mit Docling um, das OCR ausführt.

Was kostet eine Umwandlung?

1 Credit mit API-Schlüssel. Ein abgelehnter oder fehlgeschlagener Aufruf kostet nichts. Ohne Schlüssel laufen Aufrufe mit dem anonymen Rate-Limit und dem kostenlosen Tageskontingent.

Wird meine Datei gespeichert?

Nein. Die Datei wird im Arbeitsspeicher umgewandelt, und das Markdown kommt in der Antwort zurück.