API: HTML 转纯文本 / Markdown

端点

POST /api/v1/tools/html/convert/html2txt/basic

支持 GET 和 POST，无需鉴权。

---

请求参数

参数	类型	必填	说明
html_code	string	是（与 url 二选一）	待转换的 HTML 字符串
url	string	否	抓取目标网页 HTML，与 html_code 二选一
output_format	string	否	text（默认）或 markdown

html_code 与 url 至少传一个，无需登录。

---

响应格式

成功

{
  "status": "ok",
  "output_format": "text",
  "result": "转换后的纯文本内容"
}

{
  "status": "ok",
  "output_format": "markdown",
  "result": "# 标题\n\n段落文本..."
}

失败

{
  "status": "error",
  "message": "html_code or url is required"
}

---

示例

curl — 转纯文本

curl -X POST https://cuobiezi.net/api/v1/tools/html/convert/html2txt/basic \
  -d "html_code=<h1>标题</h1><p>段落内容</p>" \
  -d "output_format=text"

响应：

{"status":"ok","output_format":"text","result":"标题\n段落内容"}

curl — 通过 URL 抓取转文本

curl -X POST https://cuobiezi.net/api/v1/tools/html/convert/html2txt/basic \
  -d "url=https://example.com" \
  -d "output_format=text"

响应：

{"status":"ok","output_format":"text","result":"Example Domain\n..."}

curl — 转 Markdown

curl -X POST https://cuobiezi.net/api/v1/tools/html/convert/html2txt/basic \
  -d "html_code=<h1>标题</h1><p>段落内容</p>" \
  -d "output_format=markdown"

响应：

{"status":"ok","output_format":"markdown","result":"# 标题\n\n段落内容"}

Python（AI Agent 调用示例）

import requests

# 方式一：直接传 html_code
resp = requests.post(
    "https://cuobiezi.net/api/v1/tools/html/convert/html2txt/basic",
    data={
        "html_code": html_string,
        "output_format": "text",   # 或 "markdown"
    },
    timeout=30,
)
data = resp.json()
if data["status"] == "ok":
    print(data["result"])

# 方式二：传 url，由服务端抓取（无需登录）
resp = requests.post(
    "https://cuobiezi.net/api/v1/tools/html/convert/html2txt/basic",
    data={
        "url": "https://example.com",
        "output_format": "text",
    },
    timeout=30,
)
data = resp.json()
if data["status"] == "ok":
    print(data["result"])

---

错误码说明

message	原因
html_code or url is required	两个参数均为空
unsupported output_format, use 'text' or 'markdown'	output_format 值非法
markdown convert failed: ...	Markdown 转换内部错误，详见 message