apyhub
DEVELOPER TOOLS · FILE CONVERSION

Convert Markdown to HTML content API

Hosted on ApyHub

What it does

Markdown to HTML converts Markdown text into HTML, so you can render user-authored content in your app, CMS, or documentation pipeline.

Send either a Markdown string in the body.content field or raw text/plain Markdown in the request body. The service returns the converted HTML as a binary stream on /json/raw, or as a JSON envelope containing a data field on /raw/json. Both endpoints are built for the same core task: turning Markdown into HTML output you can store, render, or pass to another step.

Use Markdown to HTML when you need to accept lightweight formatted text from editors, support articles, README content, or message templates and publish it as HTML. It fits neatly into content workflows where authors write Markdown but your frontend or downstream system expects HTML.

The responses are intentionally simple. You get the converted HTML string, with no extra metadata or transformation fields to map.

▣ ENDPOINT 01 / 02
POST
Convert JSON Markdown content to raw HTML stream
http://localhost:8080/apyhub/convert-markdown-to-html/json/raw
QUICKSTARTGUIDE

Quickstart

Convert a Markdown string into HTML by sending the required content field as JSON.

curl -X POST "http://localhost:8080/apyhub/convert-markdown-to-html/json/raw" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"# Title\n\nBody text."}'

What you'll get back

Returns a binary response containing the generated HTML output.

TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Markdown string to convert. Mandatory.

About this endpoint

What it does

Converts the Markdown string you send in the request body into a raw HTML stream. The endpoint returns the raw HTML in response body.

Request Body

ParameterTypeMandatoryDescription
contentStringYesMarkdown string to convert. Mandatory.

Response

Returns the converted HTML generated from the provided Markdown content.

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 02 / 02
POST
Convert raw text/plain Markdown body to HTML JSON envelope
http://localhost:8080/apyhub/convert-markdown-to-html/raw/json
QUICKSTARTGUIDE

Quickstart

Convert Markdown to HTML by sending the markdown text in the request body.

curl -X POST "http://localhost:8080/apyhub/convert-markdown-to-html/raw/json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: text/plain" \
  --data-binary #x27;# Hello world\n\nThis is **bold** markdown.'

What you'll get back

Returns a JSON object with a data string field containing the converted HTML, without newlines.

{
  "data": "<h1>Hello world</h1><p>This is <strong>bold</strong> markdown.</p>"
}
TRY ITLIVE · 50 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a raw Markdown string sent in the request body into HTML and returns the converted HTML as a JSON string in the data field.

Request Body

ParameterTypeMandatoryDescription
bodyStringYesRaw Markdown content to convert to HTML.

Response

Returns a JSON object with a data string field containing the converted HTML string without newlines. On success, the response schema defines a single top-level data field.

ParameterTypeMandatoryDescription
dataStringYesConverted HTML string without newlines.

Body

Name
Type
Description
bodyREQUIRED
string
▣ 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.