Markdown转微信公众号HTML
功能简介
调用渲染接口，将 Markdown 文本转换为适合公众号草稿 content 使用的 HTML。可按需指定主题 ID，也可让接口自动选择主题；如需保留完整响应，可额外将接口返回写入所选输出目录中自动创建的 JSON 文件。
使用场景
- 将已有 Markdown 正文转换为公众号可用 HTML
- 在正式渲染前先通过【获取微信公众号主题列表】挑选固定主题
- 渲染后把 HTML 继续传给草稿创建或发布步骤
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Markdown内容 | 字符串 | 是 | 直接传入 Markdown 文本内容 |
| 微信AccessToken | 字符串 | 是 | 由【获取微信公众号AccessToken】获取；接口统一要求传入，文章有图片时可直接处理微信图片上传 |
| 主题ID | 字符串 | 否 | 指定主题 ID；可先通过【获取微信公众号主题列表】查看可用主题 ID；不填时由接口自动选择一个当前可用主题 |
| 结果JSON输出目录 | 字符串 | 否 | 若填写，则自动创建完整响应 JSON 文件并保存到该文件夹；不填则不保存 JSON |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| HTML内容 | 字符串 | 否 | 最终渲染得到的 HTML，可直接用于公众号草稿 content |
| 实际结果JSON路径 | 字符串 | 否 | 若填写了【结果JSON输出目录】，则返回本次实际写入的 JSON 文件完整路径 |
| 实际主题ID | 字符串 | 否 | 本次实际使用的主题 ID；当未传【主题ID】时，可据此确认接口最终选用了哪个主题 |
| 图片数量 | 整数 | 否 | 图片处理结果数量，对应响应中的 images 数组长度 |
| 告警数量 | 整数 | 否 | 告警条数，对应响应中的 warnings 数组长度 |
注意事项
调用顺序
通常先执行【获取微信公众号AccessToken】，如需固定风格可先执行【获取微信公众号主题列表】，再执行本指令。
返回告警
接口返回 200 时仍可能带有告警信息；若需要查看完整 warnings、images、meta 等字段，可填写【结果JSON输出目录】保存完整响应。