▣ OUTPUT KIT

Convert Markdown to PDF API

What it does

Markdown to PDF converts Markdown content into a downloadable PDF or a signed S3 URL. Send raw Markdown, a file upload, or a URL that points to a Markdown document, and you get the rendered PDF back in the format you choose.

Use the raw Markdown endpoints when your application already has the content in memory. The request body is the Markdown text itself, and the response is either a binary PDF download or a JSON object containing a data field with a signed S3 URL valid for 5 minutes. Use the file and URL endpoints when you want to convert an existing .md file or a remote Markdown resource instead.

The input limits are explicit: raw Markdown accepts up to 5 MB, URL-based conversion requires a remote resource served as text/markdown or text/plain and capped at 5 MB, and file uploads must be text/markdown, text/plain, or a .md file up to 3 MB. That makes Markdown to PDF a good fit for generating reports, documentation exports, or customer-facing handouts from content your system already stores as Markdown.

Choose the download response when you want to stream the PDF directly to a user, or the signed URL response when a downstream service needs to fetch the generated file later.

▣ ENDPOINT 01 / 06

POST

URL → PDF (file download)

https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-url-pdf-file

QUICKSTART

GUIDE

Quickstart

Convert a Markdown file at a public URL into a PDF download.

curl -X POST "https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-url-pdf-file?output=sample-output" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.md"}'

What you'll get back

Returns a downloadable PDF file as binary data. The response body is the rendered PDF itself, not a JSON object.

TRY ITLIVE · 50 ATOMS

Loading playground…

About this endpoint

What it does

Converts a Markdown file available at a URL into a PDF and returns the rendered document as a downloadable file.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output filename base. Default: `sample-output`.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	URL pointing to a Markdown file. The remote resource must respond with a `Content-Type` of `text/markdown` or `text/plain` and must not exceed 5 MB.

Response

Returns a downloadable PDF file as a binary response. The output is a binary file rendered from the Markdown input.

Parameter	Type	Mandatory	Description
binary	String	Yes	Downloadable PDF file rendered from the Markdown input.

▣ ENDPOINT 02 / 06

POST

URL → PDF (S3 URL)

https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-url-pdf-url

QUICKSTART

GUIDE

Quickstart

Convert a Markdown file at a public URL into a PDF and return a signed download link.

curl -X POST "https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-url-pdf-url?output=my-document" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.md"}'

What you'll get back

Returns a JSON object with a data string field containing a signed S3 URL for the generated PDF file, valid for 5 minutes.

{
  "data": "https://s3.amazonaws.com/bucket/consumer/converter-markdown-pdf/file.pdf?..."
}

TRY ITLIVE · 50 ATOMS

Loading playground…

About this endpoint

What it does

Converts a Markdown file available at a URL into a PDF and returns a signed S3 URL for the generated PDF file.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output file name base. Default: `sample-output`.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	URL pointing to a Markdown file. Must be a valid URI. The remote resource must respond with `Content-Type: text/markdown` or `text/plain` and must not exceed 5 MB.

Response

Returns a JSON object with a data string field containing a signed S3 URL for the generated PDF file. The URL is valid for 5 minutes.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed S3 URL for the generated PDF file. Valid for 5 minutes.

▣ ENDPOINT 03 / 06

POST

File upload → PDF (file download)

https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-file-pdf-file

QUICKSTART

GUIDE

Quickstart

Convert a Markdown file into a PDF download.

curl -X POST "https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-file-pdf-file" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/file.md"

What you'll get back

Returns a downloadable PDF file as binary data.

(binary PDF file)

TRY ITLIVE · 50 ATOMS

Loading playground…

About this endpoint

What it does

Converts an uploaded Markdown file into a PDF and returns the generated PDF as a downloadable binary response.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output name for the generated file. Default: `sample-output`.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Markdown file to convert. Must have MIME type `text/markdown` or `text/plain`, or a `.md` file extension. Maximum size 3 MB.

Response

Returns a downloadable PDF file as a binary response. The success response is a binary PDF generated from the Markdown input.

Parameter	Type	Mandatory	Description
binary	String	Yes	Downloadable PDF file rendered from the Markdown input.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 04 / 06

POST

File upload → PDF (S3 URL)

https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-file-pdf-url

QUICKSTART

GUIDE

Quickstart

Upload a Markdown file to generate a PDF download link.

curl -X POST "https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-file-pdf-url?output=my-document" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/document.md"

What you'll get back

Returns a JSON object with a data string field containing a signed S3 URL for the generated PDF file.

{
  "data": "https://s3.amazonaws.com/bucket/consumer/converter-markdown-pdf/file.pdf?..."
}

TRY ITLIVE · 50 ATOMS

Loading playground…

About this endpoint

What it does

Converts an uploaded Markdown file into a PDF and returns a signed S3 URL for the generated PDF file.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Default: `sample-output`

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Markdown file to convert. Must have MIME type `text/markdown` or `text/plain`, or a `.md` file extension. Maximum size 3 MB.

Response

Returns a JSON object with a data string field containing a signed S3 URL for the generated PDF file, valid for 5 minutes.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed S3 URL for the generated PDF file (valid for 5 minutes).

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 05 / 06

POST

Raw Markdown → PDF (file download)

https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-raw-pdf-file

QUICKSTART

GUIDE

Quickstart

Convert raw Markdown into a downloadable PDF by sending the Markdown text in the request body.

curl -X POST "https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-raw-pdf-file" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary #x27;# Title\n\n## Section\n\nParagraph text here.\n'

What you'll get back

Returns a binary PDF file (string with format: binary) rendered from the Markdown input.

PDF file download

TRY ITLIVE · 50 ATOMS

Loading playground…

About this endpoint

What it does

Converts raw Markdown content into a PDF file and returns the rendered PDF as downloadable binary output.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output name for the generated file. Default: `sample-output`.

Request Body

Parameter	Type	Mandatory	Description
body	String	Yes	Raw Markdown content. Maximum size 5 MB.

Response

Returns a binary PDF file download. The success response is a single binary payload, not a JSON object.

Parameter	Type	Mandatory	Description
binary	String	Yes	Downloadable PDF file rendered from the Markdown input.

▣ ENDPOINT 06 / 06

POST

Raw Markdown → PDF (S3 URL)

https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-raw-pdf-url

QUICKSTART

GUIDE

Quickstart

Send your raw Markdown in the request body to generate a PDF and receive a signed download URL.

curl -X POST "https://api.eu.apyverse.com/apyhub/markdown-to-pdf/md-raw-pdf-url" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary #x27;# Title\n\n## Section\n\nParagraph text here.\n'

What you'll get back

Returns a JSON object with a data string field — a signed S3 URL for the generated PDF file, valid for 5 minutes.

{
  "data": "https://s3.amazonaws.com/bucket/consumer/converter-markdown-pdf/file.pdf?..."
}

TRY ITLIVE · 50 ATOMS

Loading playground…

About this endpoint

What it does

Converts raw Markdown content into a PDF and returns a signed S3 URL for the generated file. The request accepts the Markdown text in the body and can optionally take an output query parameter.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output name. Default: `sample-output`.

Request Body

Parameter	Type	Mandatory	Description
body	String	Yes	Raw Markdown content. Maximum size 5 MB.

Response

Returns a JSON object with a data string field containing a signed S3 URL for the generated PDF file. The URL is valid for 5 minutes.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed S3 URL for the generated PDF file. Format: URI. Valid for 5 minutes.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLConvert Markdown to JSON APIApyHub CALLConvert JSON to Markdown APIApyHub CALLConvert Markdown to HTML files APIApyHub CALLConvert Markdown to HTML content APIApyHub

From the blog

Reads that touch this API.

Change Log - 17 October 2023Jul 8, 2026 building blogSep 23, 2026 How APIs Are Accelerating Modern Software DevelopmentJul 23, 2026 ChangeLog ApyHub Fusion - November 2024Jul 9, 2026