HTML转markdown-文档转Markdown-docx转markdown API接口介绍

前言

日常办公和系统开发中，经常要面对Word、HTML等格式转Markdown的需求——知识库沉淀、接口文档整理、项目说明写作，哪样都绕不开。手动转换？费时费力不说，格式错乱、图片丢失、排版不统一简直是家常便饭。更何况不同文档的标签和样式差异，光是清理冗余就能让人头大。为了解决这些痛点，设计了一套文档与HTML转Markdown的方案：通过解析文档结构、过滤冗余样式标签、统一标题/表格/列表等排版规则，自动完成格式转换，同时完整保留原文内容结构。这套转换工具能快速适配技术文档、业务资料等常见场景，大幅提升整理效率，保障多平台下的文档格式统一，方便在线查阅和版本管理。

应用场景

：把Word、HTML格式的需求文档、设计说明批量转为Markdown，统一文档格式，在线知识库归档、查阅、版本管理一步到位。：网页版接口说明、HTML接口文档快速转换成Markdown，直接对接代码仓库和接口管理平台，开发协作效率明显提升。：本地Word稿件、网页资讯内容一键转Markdown，省去手动排版的繁琐，发布到技术社区或个人博客更顺滑。：规章制度、培训手册等多格式文档统一转码，文档轻量化存储、多终端高效分享，管理成本自然降低。：各类网页、Word说明文档转成Markdown，用于项目README、使用手册编写，轻松适配开源平台的文档规范。

API介绍

请求参数

名称	类型	必须	说明
appId	String	是	服务商分配的唯一标识。
timestamp	Long	是	当前时间毫秒数。
sign	String	是	签名，详见签名算法说明。
html	String	否	待转换的 HTML 内容。html、file、url 至少传一个；优先级：file > url > html。
file	File	否	待转换文件，支持 .html、.htm、.docx，文件大小限制 3M 以内。Word 文件仅支持 .docx，不支持 .doc。html、file、url 至少传一个；传 file 时优先处理文件。
url	String	否	Word .docx 文档公网地址，仅支持 .docx 文件，不支持 .doc，文件大小限制 3M 以内。html、file、url 至少传一个；仅在未传 file 时生效。
imageMode	String	否	图片处理模式：zip 图片单独解析并打包返回 .zip；base64 图片内嵌到 Markdown 并返回 .md；不传默认 zip。

返回样例

{ "code": 200,// 返回码，详见code返回码说明"msg": "成功",// code对应的描述"taskNo": "193000000000000000000001",// 本次请求号"charge": true,// 计费标志"data": {   "url": "https://file.jumdata.com/office/html-to-markdown/20260604/xxxxxxxx.zip"// 压缩包地址，内含 md 文件和图片文件}
}