1. POST your Markdown
Send Markdown plus optional theme and page size as JSON. The endpoint renders the document inside the same request.
API
Convert Markdown to PDF via API
A synchronous Markdown → PDF rendering endpoint
POST a JSON body with your Markdown, theme, and page size and the endpoint returns the rendered PDF in the same response. There is no job queue to manage — it uses a Typst rendering pipeline.
Recommended integration flow
2. Receive the PDF directly
The response body is the PDF binary itself (application/pdf). There is no job ID and nothing to poll.
3. Save or forward it
Write the bytes to disk, attach them to an email, or stream them back to your user.
Quick Start
curl -X POST https://justmarkdown.com/api/v1/convert \
-H "Content-Type: application/json" \
-d '{"markdown":"# Hello","theme":"Academic","pageSize":"A4"}' \
-o document.pdfParameters
- markdown
- string (required) - Your Markdown content
- theme
- Academic | Business | Minimal (default: Academic)
- pageSize
- A4 | Letter | Legal (default: A4)
Remote MCP endpoint
Add this to your `mcp.json`. API keys are only used here (optional):
{
"mcpServers": {
"justmarkdown": {
"type": "http",
"url": "https://justmarkdown.com/api/mcp"
}
}
}MCP account keys are billed 1 credit per conversion; anonymous calls use the daily free tier.
Full MCP setup guide →Credits & billing
/api/v1/convert(Markdown → PDF) and text-based PDFs are free.- AI OCR for scanned PDFs: 1 credit per page. Text-based PDFs cost nothing.
- Audio transcription: 1 credit per started minute.
- MCP conversions (
/api/mcp, account API Key): 1 credit per call.
Rate Limits
This endpoint is unauthenticated and governed by fair use; there is no published per-minute cap.
What to expect before you integrate
- Synchronous: one request renders and returns exactly one PDF.
- Unauthenticated — no API key is required for /api/v1/convert.
- For asynchronous document-to-Markdown jobs (with auth, quotas and SSE), use the developer API documented at /developers.
Frequently asked questions
What can this endpoint convert?
Only Markdown → PDF. It accepts Markdown text and returns a PDF; it does not accept uploaded files and does not return DOCX.
Is the API asynchronous?
No. `/api/v1/convert` is synchronous: the request stays open until the PDF is ready. For the asynchronous document-to-Markdown job API, see the developer page.
Do I need an API key?
`/api/v1/convert` is unauthenticated and governed by fair use. API keys (created in account settings) are only used by the remote MCP endpoint at `/api/mcp` — not by this endpoint or `/api/jobs`.
Related Resources
- Documentation — user guides for capturing, editing, and sharing Markdown
- Developer API — queue document-to-Markdown conversion jobs from your agent or script
- All Markdown Tools — browse the full converter suite
- Markdown to PDF — the interactive web tool behind this API
- Open the Workspace — try conversions in the browser