# Markdown to PDF Converter

> Publish polished, task-specific PDFs from Markdown through a visual converter,
> a versioned REST API, a remote MCP server, or reviewed no-code automations.

## Start here

- [Interactive converter](https://markdowntopdfconverter.com/convert): paste or upload Markdown, choose a task-specific template, preview, and export.
- [Real PDF template gallery](https://markdowntopdfconverter.com/templates): inspect renders produced by the same engine used for downloads.
- [API and MCP reference](https://markdowntopdfconverter.com/api-docs): managed publishing lifecycle, scoped authentication, templates, errors, limits, and pricing.
- [OpenAPI v2](https://markdowntopdfconverter.com/openapi-v2.json): machine-readable public-beta publishing contract.
- [Guides](https://markdowntopdfconverter.com/learn): task-first formatting, design, templates, and automation.
- [Pricing](https://markdowntopdfconverter.com/pricing): free trial, subscriptions, and API credits.

## Managed Publishing API v2

Base URL: `https://markdowntopdfconverter.com`

1. `POST /api/v2/documents` creates a managed source and immutable revision.
2. `POST /api/v2/documents/{documentId}/publishes` starts a final PDF job.
3. `GET /api/v2/jobs/{jobId}` is polled until `succeeded`, `failed`, or `cancelled`.
4. `POST /api/v2/artifacts/{artifactId}/links` creates a short-lived private link.
5. Fetch the returned signed URL without forwarding the API key.

Use `Authorization: Bearer mp_live_...` on API requests. The normal publishing
key needs only `documents.render` and `documents.read`. Mutations require a
stable `Idempotency-Key`; retries must reuse the same key and canonical body.
Artifacts include SHA-256 provenance and final PDFs are retained for seven days.

## Automation kits

- [n8n workflow](https://markdowntopdfconverter.com/downloads/integrations/n8n): inactive import with persisted waits and terminal failure handling.
- [Make blueprint](https://markdowntopdfconverter.com/downloads/integrations/make): unbound credentials, bounded polling, and duplicate-download guard.
- [Zapier setup kit](https://markdowntopdfconverter.com/downloads/integrations/zapier): SDK Code step plus reviewed guided-template manifest.

Credentials belong in each platform's connection manager, never inside exported
workflow fields. Signed artifact URLs are already credentials and must not
receive the bearer API key.

## AI agents

- Remote MCP endpoint: `https://markdowntopdfconverter.com/mcp`
- MCP tools: `recommend_document_templates`, `list_pdf_templates`, and `generate_pdf`
- MCP results use private download links that expire after 15 minutes.

## Legacy direct conversion

`POST /api/v1/convert` remains available for existing one-request integrations.
It returns raw PDF bytes on success. New repeat-publishing integrations should
use API v2. See the [migration guide](https://markdowntopdfconverter.com/api-v2-migration.md).

## Product facts

- Built-in families cover resumes, cover letters, academic papers, books, reports, proposals, legal documents, assignments, and visual publications.
- Saved custom templates can include fonts, logos, backgrounds, visual layers, QR codes, and reusable brand assets.
- A signed-up free account can try up to five premium PDF exports before upgrading.
- The site and rendering flow support English, Spanish, French, German, Japanese, Simplified Chinese, Korean, Brazilian Portuguese, Arabic, Russian, Hindi, and Italian.