功能简介
调用渲染接口,将 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输出目录】保存完整响应。
