根治HTML转MD格式错乱！高兼容性API网关设计指南

在开发和内容管理过程中，将HTML内容转换为Markdown格式是一个常见的需求。万维易源提供的“HTML转换MD”API为开发者提供了一个高效、便捷的工具，可以通过简单的接口调用将HTML内容转换为Markdown格式。本文将详细介绍如何使用该API，以及其核心功能和调用方法。

一、API概述

1. 接入点说明

该API支持将HTML内容转换为Markdown格式。用户只需要提供HTML源码，API将返回对应的Markdown格式内容。

2. 接口地址

```
https://route.showapi.com/3193-1?appKey={your_appKey}
```

请将 `{your_appKey}` 替换为你在万维易源平台申请的个人 `appKey`。

二、请求参数

以下是提交HTML转Markdown任务所需的请求参数：

表格

参数名称	类型	示例值	必须	描述
html	String	（HTML源码）	是	网页的HTML源码。

三、返回参数

以下是接口返回的参数及其描述：

表格

参数名称	类型	示例值	描述
markdown	String	（Markdown格式内容）	转换后的Markdown格式内容。
ret_code	Number	0	返回码，0 表示成功，其他值表示失败。
remark	String	（错误信息）	错误信息，仅在 ret_code 不为 0 时返回。

四、调用示例

以下是一个使用 `curl` 命令调用该接口的示例：

#查看appkey: https://www.showapi.com/console#/myApp
curl 'https://route.showapi.com/3193-2?appKey=your_appKey' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'task_name=' \
  -d 'ret_type=markdown' \
  -d 'html=%20%3C!DOCTYPE%20HTML%20PUBLIC%20%22-%2F%2FW3C%2F%2FDTD%20HTML%204.01%20Transitional%2F%2FEN%22%20%22http%3A%2F%2Fwww.w3.org%2FTR%2Fhtml4%2Flo...%E5%B7%B2%E7%9C%81%E7%95%A5' \
  -d 'run_type=async'

请将 your_appKey 替换为你在万维易源平台申请的 appKey

五、返回示例

以下是接口返回的JSON示例：

{
  "remark": "请求成功",
  "md_text": "",
  "task_id": "",
  "ret_code": 0
}

六、获取appKey

要获取 appKey，请访问万维易源的控制台页面：

查看 appKey

七、总结

万维易源的“HTML转换MD”API为开发者提供了一个高效、便捷的工具，可以通过简单的接口调用将HTML内容转换为Markdown格式。希望本文能帮助你更好地了解和使用该API。如果你有任何问题或需要进一步的帮助，请随时访问万维易源的官方文档或联系技术支持。