Create your first polished PDF

Create a publishing key

Create a free account and generate a publishing key. New accounts can produce five premium PDFs before an upgrade is required, and no payment card is needed.

Create your document

This request creates a managed document and its first immutable revision. The template ID controls the finished design, while Markdown remains the source of truth.

curl --request POST \
  "https://markdowntopdfconverter.com/api/v2/documents" \
  -H "Authorization: Bearer $MD2PDF_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --data '{
    "taskId": "first-polished-report",
    "revision": {
      "markdown": "# Quarterly brief\n\nA concise, polished report.",
      "spec": {
        "templateId": "executive",
        "locale": "en"
      }
    }
  }'

Publish and download

Publish the returned revision ID, poll the job until it reaches a terminal state, then create a short-lived artifact link. The full production guide adds bounded polling, retry jitter, and webhook delivery.

• Reuse the same Idempotency-Key when retrying an identical mutation.
• Honor Retry-After for 429 and 503 responses.
• Download signed artifact URLs without forwarding your API key.