HTML to Markdown
POST
/v1/convert/html-to-markdown
curl -X POST "https://convert.toolkitapi.io/v1/convert/html-to-markdown" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"html": "<h1>Hello</h1><p>This is <strong>bold</strong>.</p>"}'
# See curl example
// See curl example
Response
200 OK
{
"markdown": "# Hello\n\nThis is **bold**.\n",
"size": 30
}
How to Use
1
Send a POST request to /v1/convert/html-to-markdown with an html string.
About This Tool
Convert HTML back to clean Markdown using tag-to-syntax mapping. Handles headings, paragraphs, links, images, lists, tables, code blocks, and inline formatting.
Produces readable Markdown that round-trips cleanly back to HTML. Unsupported tags are stripped, preserving their text content.
Why Use This Tool
- Content Migration — Migrate HTML content from legacy CMS systems to Markdown-based platforms.
- Web Scraping — Convert scraped HTML articles to Markdown for cleaner storage and processing.
Frequently Asked Questions
Are tables converted?
Yes — HTML tables are converted to Markdown pipe tables with header alignment.
What about iframes and forms?
Non-content elements (iframes, forms, scripts) are stripped entirely.
Start using HTML to Markdown now
Get your free API key and make your first request in under a minute.