text-html-to-markdown Edge Function — Content

text-html-to-markdown — Convert HTML to Markdown

Converts HTML content to clean Markdown text. Strips unknown tags while preserving headings, bold, italic, links, code, lists, and blockquotes.

---

API

POST /api/text-html-to-markdown

Request body

Field	Type	Required	Default	Description
html	string	✅	—	The HTML string to convert
preserveLinks	boolean	❌	true	Convert <a href> to [text](url) syntax, or strip to plain text

Success response (200)

{
  "success": true,
  "data": {
    "markdown": "# Hello World\n\nThis is **bold** and *italic*.",
    "charCount": 44
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Missing or invalid html field
INTERNAL_ERROR	500	Unexpected processing error

---

Usage

cURL

curl -X POST "$FUNCTION_URL/api/text-html-to-markdown" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h1>Hello</h1><p>This is <strong>bold</strong>.</p>"}'

TypeScript / JavaScript (HTTP)

const response = await fetch(`${FUNCTION_URL}/api/text-html-to-markdown`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    html: '<h1>Hello</h1><p>This is <strong>bold</strong>.</p>',
    preserveLinks: true,
  }),
});
const { data } = await response.json();
console.log(data.markdown);
// # Hello
//
// This is **bold**.
console.log(data.charCount); // 26

Direct import (Node / Bun / Deno)

import { htmlToMarkdown } from '@aerostack/functions/text-html-to-markdown';

const result = htmlToMarkdown({
  html: '<ul><li>Item one</li><li>Item two</li></ul>',
  preserveLinks: true,
});
console.log(result.markdown);
// - Item one
// - Item two

---

Use Cases

• Web scraping pipelines: Convert scraped HTML pages to Markdown before inserting into LLM prompts or RAG pipelines.
• CMS content migration: Convert legacy HTML articles to Markdown for storage in headless CMS systems or Git-based content repos.
• Document editing: Transform pasted HTML content into clean Markdown for storage in a Markdown-first editor.
• AI context preparation: Extract readable text from email HTML or rich-text content before passing to an AI model.

---

Notes

• Multiple blank lines (3+) are collapsed to a maximum of 2 to produce clean output.
• HTML entities (&, <, ", etc.) are decoded in the output.
• HTML comments are stripped entirely.
• Unrecognized tags (e.g. <div>, <span>, <table>) are removed but their text content is preserved.