Markdown Text to HTML Converter API - ApyHub

Convert Markdown to HTML content API

File Conversion#content#convert#html#markdown
ApyHub
ApyHub
verified icon
50 atoms

About

The Markdown Text to HTML API lets you transform raw Markdown text into HTML quickly and accurately. It also supports converting JSON Markdown to JSON HTML, ensuring minimal loss of formatting and data.
This API is perfect for developers who want to automate documentation and content workflows. Common use cases include:
  • Converting Markdown documentation or README files into HTML for web apps or dashboards
  • Transforming JSON-based Markdown content into HTML for dynamic websites or APIs
  • Automating blog, article, or knowledge base publishing from Markdown to HTML
  • Ensuring consistent styling and layout across multiple pages, sites, or web projects
While Markdown is great for simple text formatting, converting it to HTML enhances functionality, accessibility, and compatibility, making your content ready for any browser or device.
Try out the Markdown Text to HTML API in the API playground for free, improve your document workflow, and reduce HTML conversion errors with a single API call.
Select API Endpoints
Input

API Playground

API Documentation

submit raw MD: generated raw HTML
POST
https://api.apyhub.com/convert/md/html/raw

Request example

1
curl --location --request POST 'https://api.apyhub.com/convert/md/html/raw' \
2
--header 'apy-token: {{token}}' \
3
--header 'Content-Type: text/plain' \
4
--data-raw '# Heading 1
5
## Heading 2
6
### Heading 3
7


8
**Bold text**
9


10
*Italic text*
11


12
- Unordered list item 1
13
- Unordered list item 2
14
  - Nested unordered list item
15


16
1. Ordered list item 1
17
2. Ordered list item 2
18
   1. Nested ordered list item'
The method lets you pass a raw markdown in body and returns the converted raw html as an output.
Method: POST
Content Type: text/plain
Request Body
TypeMandatoryDescription
Raw MarkdownYesProvide the raw markdown content as plain text in the text/plain format.
Sample Response
1
<h1>Heading 1</h1>
2
<h2>Heading 2</h2>
3
<h3>Heading 3</h3>
4
<p><strong>Bold text</strong></p>
5
<p><em>Italic text</em></p>
6
<ul>
7
	<li>Unordered list item 1</li>
8
	<li>Unordered list item 2
9
		<ul>
10
			<li>Nested unordered list item</li>
11
		</ul>
12
	</li>
13
</ul>
14
<ol>
15
	<li>Ordered list item 1</li>
16
	<li>Ordered list item 2
17
		<ol>
18
			<li>Nested ordered list item</li>
19
		</ol>
20
	</li>
21
</ol>

HTTP Response Codes

The method may return one of the following HTTP status codes:
Status CodeDescription
200The request was successful.
400Request is invalid or url is not accessible.
401Required authentication information is either missing or not valid for the resource.
500There was an error in processing this request.

Authentication

All API requests to ApyHub services need to be authenticated. Currently we support tokens or basic authentication mechanisms. You can generate and view your existing credentials from your workspace settings (on the left side of the navbar) and go to “API Keys".
Points to note:
  • Credential secrets are generated on the fly and are not stored in plain text, so on generating a credential please save the secrets somewhere safe.
  • Use the apy-token as the header parameter to pass the token.
  • Use the Authorization header to send the basic authentication credentials.

Error codes

1
{
2
  "error": {
3
    "code": 105,
4
    "message": "Invalid URL"
5
  }
6
}
To search for a specific error code, enter the code in the search box below. Alternatively, you can click on the button to view a complete list of all error codes.
Table of contents
AboutAPI PlaygroundAPI DocumentationAuthenticationError codesRelated Utility APIsRelated Articles