Markdown to HTML
Convert Markdown text to HTML in a single API call. Optionally sanitize the output to strip unsafe tags and prevent XSS.
Overview
Use Cases
- Rendering user-generated Markdown content safely in web apps
- Converting README files or documentation to HTML
- Building rich-text editors with Markdown input and HTML preview
- Preprocessing Markdown before storing rendered HTML
Features
Full CommonMark Markdown support
Optional HTML sanitization to strip unsafe tags and attributes
Returns ready-to-render HTML string
API Endpoints
Convert Markdown to HTML
Converts a Markdown string to HTML. Pass sanitize true to strip potentially unsafe tags like script and iframe from the output.
POST
https://requiems.xyz/v1/technology/markdown
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| markdown | string |
Required | The Markdown text to convert. |
| sanitize | boolean |
Optional | When true, sanitizes the HTML output to remove unsafe tags and attributes. |
Try it out
Live DemoRequest
The Markdown text to convert.
When true, sanitizes the HTML output to remove unsafe tags and attributes.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| html | string |
The rendered HTML output |
Code Examples
curl -X POST https://requiems.xyz/v1/technology/markdown \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"markdown": "# Hello\n\nThis is **bold** text.", "sanitize": true}'import requests
url = "https://requiems.xyz/v1/technology/markdown"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"markdown": "# Hello\n\nThis is **bold** text.",
"sanitize": True
}
response = requests.post(url, json=payload, headers=headers)
print(response.json()['data']['html'])const response = await fetch(
'https://requiems.xyz/v1/technology/markdown',
{
method: 'POST',
headers: {
'requiems-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
markdown: '# Hello\n\nThis is **bold** text.',
sanitize: true
})
}
);
const { data } = await response.json();
console.log(data.html);require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/technology/markdown')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
markdown: "# Hello\n\nThis is **bold** text.",
sanitize: true
}.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.parse(response.body)['data']['html']Error Responses
422
unprocessable_entity
Convert Markdown Batch
Converts multiple Markdown strings into HTML in a single request. Results are returned in the same order as the input array. Supports optional sanitization to remove unsafe HTML tags such as script and iframe.
POST
https://requiems.xyz/v1/technology/markdown/batch
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| markdowns | array<string> |
Required | Array of Markdown strings. Min: 1, Max: 50. |
| sanitize | boolean |
Optional | When true, sanitizes HTML output to remove unsafe tags and attributes. |
Try it out
Live DemoRequest
Array of Markdown strings. Min: 1, Max: 50.
When true, sanitizes HTML output to remove unsafe tags and attributes.
Sending request...
Response Fields
| Field | Type | Description |
|---|---|---|
| results | array<object> |
One HTML result per Markdown input, preserving input order |
| results[].html | string |
Rendered HTML output for each Markdown string |
Code Examples
curl -X POST https://requiems.xyz/v1/technology/markdown/batch \
-H "requiems-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"markdowns": ["# Hello", "**bold**", "- item"],
"sanitize": true
}'import requests
url = "https://requiems.xyz/v1/technology/markdown/batch"
headers = {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
}
payload = {
"markdowns": ["# Hello", "**bold**", "- item"],
"sanitize": True
}
response = requests.post(url, json=payload, headers=headers)
results = response.json()["data"]["results"]
for r in results:
print(r["html"])const response = await fetch(
"https://requiems.xyz/v1/technology/markdown/batch",
{
method: "POST",
headers: {
"requiems-api-key": "YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
markdowns: ["# Hello", "**bold**", "- item"],
sanitize: true
})
}
);
const { data } = await response.json();
console.log(data.results);require 'net/http'
require 'json'
uri = URI('https://requiems.xyz/v1/technology/markdown/batch')
request = Net::HTTP::Post.new(uri)
request['requiems-api-key'] = 'YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = {
markdowns: ["# Hello", "**bold**", "- item"],
sanitize: true
}.to_json
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
results = JSON.parse(response.body)['data']['results']
puts resultsError Responses
validation_failed
Body is invalid: empty array, more than 50 items, or invalid Markdown entry.
bad_request
Missing or malformed request body.
internal_error
Unexpected server error.
Frequently Asked Questions
The converter follows CommonMark β the standardized Markdown specification used by GitHub, GitLab, and most modern platforms.
Enable sanitize whenever the Markdown input comes from untrusted sources (user input, third-party content). It strips tags like script, iframe, and on* event attributes to prevent XSS attacks.
No. Standard Markdown output (headings, paragraphs, bold, links, code blocks, etc.) is not affected by sanitization. Only raw HTML embedded in the Markdown is filtered.