Markdown Converter API for Developers
Convert Markdown, PDF, Word, and HTML programmatically with a single REST endpoint. Full LaTeX math and Mermaid diagram rendering, hosted and ready to call from any language. Get an API key on RapidAPI and start converting in minutes.
Markdown Conversion API Quickstart
Two calls: submit a file to get a task ID, then poll for the download URL. Every endpoint follows the same pattern.
# 1. Submit a Markdown file for PDF conversion
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/md-to-pdf" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-F "source_file=@README.md"
# -> { "task_id": "550e8400-...", "status": "processing" }
# 2. Poll for the result until status is "completed"
curl -X POST "https://markdown-converter-pro.p.rapidapi.com/apix/query-task" \
-H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
-H "X-RapidAPI-Host: markdown-converter-pro.p.rapidapi.com" \
-d "task_id=550e8400-..."
# -> { "status": "completed", "to_url": "https://.../README.pdf" }1. Submit a conversion
Send a file upload (source_file) or a public file URL (source_file_url). You get back a task_id.
2. Poll for the result
Poll query-task with the task_id until status is completed, then download from to_url.
Markdown to PDF, Word & HTML API Endpoints
All endpoints accept POST with multipart/form-data and return a task_id. Base path: /apix.
| Method | Endpoint | Description | Online Tool |
|---|---|---|---|
| POST | /apix/md-to-pdf | Convert Markdown to PDF, with LaTeX and Mermaid rendered. | Try online |
| POST | /apix/md-to-docx | Convert Markdown to an editable Word (.docx) document. | Try online |
| POST | /apix/md-to-html | Convert Markdown to clean, semantic HTML. | Try online |
| POST | /apix/pdf-to-md | Extract Markdown from a PDF, including text, tables, and images. | Try online |
| POST | /apix/docx-to-md | Convert a Word (.docx) document to Markdown. | Try online |
| POST | /apix/html-to-md | Convert an HTML page or fragment to clean Markdown. | Try online |
| POST | /apix/query-task | Poll a task by task_id and retrieve the download URL when ready. | — |
How the Async Conversion API Works
Conversions run asynchronously, so large files never block your request.
Submit
POST your Markdown, PDF, Word, or HTML file — as an upload or a public URL — to the matching endpoint.
Receive a task ID
The API immediately returns a task_id with status processing. No long-held connections.
Poll & download
Call query-task with the task_id. When status is completed, download the file from the returned to_url.
What the Markdown Converter API Renders
From LaTeX equations to Mermaid diagrams, the API turns complex Markdown into clean PDF, Word, and HTML without losing fidelity.
LaTeX Math
Inline and block LaTeX equations are rendered faithfully in PDF and Word output — ideal for academic and technical documents.
Mermaid Diagrams
Flowcharts, sequence diagrams, Gantt charts, and class diagrams written in Mermaid are rendered as real graphics.
Full GFM Support
Pipe tables, task lists, fenced code blocks with syntax highlighting, strikethrough, and auto-linking — all preserved.
Bidirectional
Convert from Markdown to PDF, Word, and HTML — or convert those formats back to clean Markdown for version control.
Markdown Conversion API Use Cases
Developers use the API to generate documents automatically — in build pipelines, product features, and bulk jobs.
CI/CD Pipelines
Generate release notes, reports, or PDF artifacts from Markdown on every build, with no headless browser to maintain.
Documentation Tooling
Turn Markdown docs into downloadable PDF or Word for users, customers, and offline reading — automatically.
Batch Conversion
Process large sets of documents server-side by passing public file URLs, then collect the results by task ID.
Markdown Converter API Pricing
The API is metered through RapidAPI with a free tier to get started and paid plans that scale with your usage. Billing, keys, and rate limits are all managed in your RapidAPI account.
Basic
30
requests / month
Pro
800
requests / month
+ $0.02 / request
Ultra
4,000
requests / month
+ $0.012 / request
Mega
12,000
requests / month
+ $0.008 / request
Quotas and prices are set on RapidAPI and may change — check the live plans for current details.
View Plans on RapidAPIMarkdown API Integration FAQ
Everything a first-time developer needs to subscribe, authenticate, send requests, and choose a plan for the Markdown conversion API.
How do I start using the Markdown conversion API?
Create a free RapidAPI account, open the Markdown Converter Pro API in the RapidAPI Hub, and subscribe to a plan — the Basic plan is free. Once you are subscribed, you can call any endpoint straight away using the code samples above.
Where do I find my API key?
After you subscribe, RapidAPI issues a personal API key for your account. You will find it in your RapidAPI dashboard and in the Code Snippets tab of any endpoint. Send it on every request as the X-RapidAPI-Key header, together with the X-RapidAPI-Host header shown alongside it.
Which conversions does the API support?
The API has six conversion endpoints — Markdown to PDF, Word, and HTML, plus the reverse from PDF, Word, and HTML back to Markdown — and a query-task endpoint for retrieving results. The endpoints table above lists the exact path for each one.
What parameters does a conversion request need?
Each conversion endpoint takes a multipart/form-data request with one of two fields: source_file to upload a file directly, or source_file_url to point at a publicly accessible file. Use one or the other — if both are sent, source_file wins. Files can be up to 50 MB, and the file type must match the endpoint, so md-to-pdf expects a .md file.
How do I get the converted file back?
Conversions run asynchronously, so a successful request returns a task_id rather than the file itself. Pass that task_id to the query-task endpoint and keep polling until the status is completed, then download the finished file from the to_url in the response.
What happens when a conversion fails?
If a conversion cannot be completed, query-task returns a failed status instead of completed. The common causes are a file type that does not match the endpoint, a source_file_url that is not publicly reachable, or a file larger than 50 MB. Correct the input and submit the request again.
Which pricing plan should I choose?
Start on the free Basic plan to test your integration, then move up to a paid plan as your monthly request volume grows. Each plan includes a monthly request quota and charges a small per-request rate beyond it — the pricing table above shows the current tiers. Billing and limits are managed in your RapidAPI account.
What happens to my files after conversion?
Your files are not kept. Uploaded documents and the converted output are processed temporarily and removed afterward, and finished files are served from a short-lived download URL rather than stored long-term.
Start Converting in Minutes
Subscribe on RapidAPI, grab your key, and make your first conversion call today.
Get Started on RapidAPI