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
/api/v2/documents{
"taskId": "consulting-proposal",
"revision": {
"markdown": "# Northstar Proposal...",
"spec": { "templateId": "proposal-consulting" }
}
}
SHA-256POST /api/v2/documents → /publishes
Schnellstart
Dokument erstellen, veröffentlichen und das verifizierte PDF herunterladen.
#!/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
- 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.
Make
Blueprint ohne Zugangsdaten, mit begrenzter Abfrage und Download-Sperre.
Zapier
SDK-Code-Schritt und Guided-Template-Manifest in einem Paket.
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.
{
"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 erstellenAuthentifizierung
Authentifizieren Sie jede Anfrage mit Ihrem geheimen API-Schlüssel, gesendet als Bearer-Token im Authorization-Header.
Anfrage-Header
| Header | Wert | Beschreibung |
|---|---|---|
| Authorization | Bearer mp_live_... | Ihr API-Schlüssel mit Bearer-Präfix |
| Content-Type | application/json | Erforderlich 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.
- 01
Verwaltetes Dokument und erste Revision erstellen.
- 02
Finales PDF mit stabilem Idempotenzschlüssel anfordern.
- 03
Bis succeeded, failed oder cancelled abfragen.
- 04
Kurzlebigen privaten Artefaktlink erzeugen.
- 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.
LebensläufeKlare Formate für einen überzeugenden ersten Eindruck.10 IDs
AnschreibenAnschreiben, die Ihren Lebenslauf passend ergänzen.10 IDs
AufgabenDurchdachte Arbeiten für Schule, College und Universität.9 IDs
AngeboteGewinnen Sie Kunden, Freigaben, Partner und Fördermittel.9 IDs
Vertrieb und MarketingProfessionelle Unterlagen für Verkauf, Nachweis und Markteinführung.9 IDs
WissenschaftLayouts für Publikation, Begutachtung und Konferenz.3 IDs
Bücher und LangformLesefreundliche Layouts für Leitfäden, Handbücher, Essays und Bücher.4 IDs
RechtlichesStrukturierte 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
| Status | code | retryable |
|---|---|---|
| 400 / 415 / 422 | invalid_request | false |
| 401 | unauthorized | false |
| 402 | quota_exhausted | false |
| 403 | forbidden | false |
| 404 | not_found | false |
| 409 | idempotency_conflict | false |
| 409 | invalid_state_transition | false |
| 410 | artifact_expired | false |
| 429 | rate_limited | true |
| 503 | service_unavailable | true |
API-Preise
API-Aufrufe werden monatlich erfasst. Jede erfolgreiche Konvertierung zählt zum monatlichen Limit Ihres Tarifs.
0 CA$
25 / month
13,91 CA$ / month
500 / month
82,14 CA$ / year
1,000 / month
6,96 CA$ one-time
250 calls
Sie brauchen mehr? Kontaktieren Sie uns für individuelle Unternehmenspreise.
Bevor du die Doku verlaesst