HTML → Markdown

POST /v1/html/to-markdown  ·  1¢

You already have the HTML: extract the readable article as Markdown — navigation, headers, footers, sidebars and scripts stripped. No browser, no network, milliseconds. The sibling of url/to-markdown.

Parameters

Name	Type	Description
html	string · required	Raw HTML (or upload a file).
mode	string · optional	article (default, strips navigation) or full.
baseUrl	string · optional	Makes relative links absolute.
output	string · optional	md (file, default) or json.

Example request

curl -X POST https://api.bigapi.dev/v1/html/to-markdown -H 'Authorization: Bearer $KEY' -H 'Content-Type: application/json' -d '{"html":"<h1>Title</h1><p>Text</p>"}' -o page.md

Example response

{
  "markdown": "# Quarterly report\n\nRevenue grew by **18 %**.\n\n| Region | Revenue |\n| --- | --- |\n| EU | 1.2m |",
  "title": "Quarterly report",
  "mode": "article"
}

When to use which

Use this when you already have the HTML — from your own fetch, a scraper or an email. If you only have a URL and the page needs JavaScript to render, use url/to-markdown instead: it renders the page in a real browser first.

Related guides