Markdown to PDF
v2 public betaREST API

Markdown-zu-PDF-API und MCP für hochwertige, aufgabenspezifische Dokumente

Erstellen Sie versionierte Markdown-Dokumente, veröffentlichen Sie hochwertige PDFs asynchron und laden Sie verifizierte Artefakte über eine gezielt berechtigte REST-API herunter.

Premium-Test

POST/api/v2/documents
{
  "taskId": "consulting-proposal",
  "revision": {
    "markdown": "# Northstar Proposal...",
    "spec": { "templateId": "proposal-consulting" }
  }
}
Executive template API request and PDF preview
verified artifactSHA-256

Schnellstart

Dokument erstellen, veröffentlichen und das verifizierte PDF herunterladen.

cURL
#!/usr/bin/env bash
set -euo pipefail

API="https://markdowntopdfconverter.com"
RUN_ID="proposal-$(date +%s)"
AUTH="Authorization: Bearer $MD2PDF_API_KEY"

DOCUMENT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/documents" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RUN_ID-document" \
  --data '{"taskId":"consulting-proposal","title":"Northstar proposal","revision":{"markdown":"# Northstar Proposal\n\n## Outcome\nA decision-ready roadmap.","parentRevisionId":null,"spec":{"locale":"en","options":{"pageNumbers":true},"templateId":"proposal-consulting"}}}')

DOCUMENT_ID=$(jq -r '.document.id' <<<"$DOCUMENT")
REVISION_ID=$(jq -r '.revision.id' <<<"$DOCUMENT")
JOB=$(curl --fail --silent --show-error --max-time 30 \
  "$API/api/v2/documents/$DOCUMENT_ID/publishes" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $RUN_ID-publish" \
  --data "{"revisionId":"$REVISION_ID","output":{"format":"pdf","filename":"northstar-proposal.pdf"}}")
JOB_ID=$(jq -r '.job.id' <<<"$JOB")

for ATTEMPT in $(seq 1 100); do
  RESULT=$(curl --fail --silent --show-error --max-time 30 "$API/api/v2/jobs/$JOB_ID" -H "$AUTH")
  STATUS=$(jq -r '.job.status' <<<"$RESULT")
  [[ "$STATUS" == "succeeded" ]] && break
  [[ "$STATUS" == "failed" || "$STATUS" == "cancelled" ]] && exit 1
  sleep 3
done
[[ "$STATUS" == "succeeded" ]] || { echo "Timed out waiting for PDF" >&2; exit 1; }

ARTIFACT_ID=$(jq -r '.artifact.id' <<<"$RESULT")
LINK=$(curl --fail --silent --show-error --max-time 30 -X POST \
  "$API/api/v2/artifacts/$ARTIFACT_ID/links" -H "$AUTH")
HREF=$(jq -r '.href' <<<"$LINK")
[[ "$HREF" == https://* ]] || { echo "Refusing non-HTTPS artifact URL" >&2; exit 1; }
curl --fail --location --proto '=https' --max-redirs 5 --max-time 60 "$HREF" \
  --output northstar-proposal.pdf
Verified PDFsucceeded
Polished consulting proposal PDF returned by the publishing API
Artifact
SHA-256
Download
private link

Mit einer geprüften Automation starten

Den vollständigen Ablauf für Veröffentlichung, Statusabfrage und privaten Download importieren.

n8n

Inaktiver Workflow mit persistenten Wartezeiten und Behandlung terminaler Fehler.

Workflow laden

Make

Blueprint ohne Zugangsdaten, mit begrenzter Abfrage und Download-Sperre.

Blueprint laden

Zapier

SDK-Code-Schritt und Guided-Template-Manifest in einem Paket.

Setup-Paket laden

Einen eigenen Schlüssel mit documents.render und documents.read verwenden. Die signierte URL ohne diesen Schlüssel laden.


Hochwertige PDF-Vorlagen in Claude Code und KI-Agenten nutzen

Verbinde den entfernten MCP-Server einmalig und lass deinen Agenten die passendsten Vorlagen für dein Dokument empfehlen oder Markdown direkt im Gespräch als hochwertiges PDF rendern.

.mcp.json
{
  "mcpServers": {
    "markdown-to-pdf": {
      "type": "http",
      "url": "https://markdowntopdfconverter.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MD2PDF_API_KEY}"
      }
    }
  }
}

MCP verwendet denselben API-Schlüssel und dasselbe Kontingent wie die REST-API. Jedes Ergebnis ist ein privater Link mit 15 Minuten Gültigkeit. Kostenlose Konten können vor dem Upgrade 5 Premium-Exporte testen.

API-Schlüssel erstellen

Authentifizierung

Authentifizieren Sie jede Anfrage mit Ihrem geheimen API-Schlüssel, gesendet als Bearer-Token im Authorization-Header.

Anfrage-Header

HeaderWertBeschreibung
AuthorizationBearer mp_live_...Ihr API-Schlüssel mit Bearer-Präfix
Content-Typeapplication/jsonErforderlich für alle Anfragen

Ein verwalteter Veröffentlichungsablauf

Quelle, unveränderliche Revision, Auftrag und geprüftes Artefakt bleiben für verlässliche Wiederholungen und Audits getrennt.

  1. 01

    Verwaltetes Dokument und erste Revision erstellen.

  2. 02

    Finales PDF mit stabilem Idempotenzschlüssel anfordern.

  3. 03

    Bis succeeded, failed oder cancelled abfragen.

  4. 04

    Kurzlebigen privaten Artefaktlink erzeugen.

  5. 05

    Signierte URL ohne Weitergabe von Authorization laden.


POST /api/v1/convert

Konvertieren Sie Markdown in ein gestaltetes PDF-Dokument.


Vorlagen

Wählen Sie aus 57 professionellen Vorlagen in 9 aufgabenspezifischen Familien. Klappen Sie eine Familie auf, um eine Vorlagen-ID zu kopieren.

Executive PDFBerichte und BriefingsGeschäftsberichte, Angebote und visuelle Briefings.2 IDs
Modernes Editorial PDFLebensläufeKlare Formate für einen überzeugenden ersten Eindruck.10 IDs
Modernes Briefpapier PDFAnschreibenAnschreiben, die Ihren Lebenslauf passend ergänzen.10 IDs
Oberstufenaufsatz PDFAufgabenDurchdachte Arbeiten für Schule, College und Universität.9 IDs
Beratungsangebot PDFAngeboteGewinnen Sie Kunden, Freigaben, Partner und Fördermittel.9 IDs
Produkt-Einseiter PDFVertrieb und MarketingProfessionelle Unterlagen für Verkauf, Nachweis und Markteinführung.9 IDs
Wissenschaftliche Publikation PDFWissenschaftLayouts für Publikation, Begutachtung und Konferenz.3 IDs
Clean PDFBücher und LangformLesefreundliche Layouts für Leitfäden, Handbücher, Essays und Bücher.4 IDs
Recht PDFRechtlichesStrukturierte Vereinbarungen und Verträge.1 IDs

Fehlercodes

Jeder v2-Fehler enthält einen stabilen Code, HTTP-Status, ein retryable-Flag und optional eine Wartezeit. Wiederholen Sie nur, wenn retryable true ist.

400 / 415 / 422invalid_request

retryable: false

401unauthorized

retryable: false

402quota_exhausted

retryable: false

403forbidden

retryable: false

404not_found

retryable: false

409idempotency_conflict

retryable: false

409invalid_state_transition

retryable: false

410artifact_expired

retryable: false

429rate_limited

retryable: true

503service_unavailable

retryable: true


API-Preise

API-Aufrufe werden monatlich erfasst. Jede erfolgreiche Konvertierung zählt zum monatlichen Limit Ihres Tarifs.

Free

0 CA$

25 / month

Starter

13,91 CA$ / month

500 / month

Pro

82,14 CA$ / year

1,000 / month

Credits

6,96 CA$ one-time

250 calls

Sie brauchen mehr? Kontaktieren Sie uns für individuelle Unternehmenspreise.

Erstelle ein Premium-PDF-Beispiel und entscheide dann, ob sich die API-Integration lohnt.

Premium-Beispiel testen