Agent API 文档API
Convert
把 Markdown 转成微信可粘贴 HTML。
Convert
What it does
把 Markdown 转成微信可粘贴 HTML。
Required headers
Content-Type: application/json
Md2wechat-API-Key: wme_your_api_keyRequest body
{
"markdown": "# 标题\n\n正文",
"theme": "default",
"fontSize": "medium",
"convertVersion": "v1"
}高级排版也走这个接口
如果你不只是想把 Markdown 转成 HTML，还想把结构一起带进去，那还是走同一个 convert。
区别在 markdown 字段里。普通正文照常写，高级排版的部分按模块语法写进去。
第一次接的话，可以先用这段：
{
"markdown": ":::hero\ntitle: 这篇值不值得读，第一屏就该说清楚\nsubtitle: 高级排版模块的任务不是把文章弄花，而是把判断、节奏和行动收拢到一起\ntags: 排版 | 模块 | 公众号\n:::\n\n:::cards[这篇会讲什么]\n判断 | 先讲值不值得看 | 不让读者滑了半天还不知道重点 | accent\n阅读 | 先让手机阅读不累 | 信息分层比堆样式更重要 | default\n转化 | 最后把动作收清楚 | 收藏、关注、咨询都要有落点 | default\n:::\n\n## 正文\n\n这里继续写普通 Markdown 正文。",
"theme": "default",
"fontSize": "medium",
"convertVersion": "v1"
}什么时候该用高级排版
更适合这些内容：
- 发布稿：要先把新东西讲清楚
- 教程稿：要让手机窄屏里不累
- 方案稿：要让读者记住判断和差异
- 服务稿：要把信任和行动收在一起
如果你只是发一条很短的消息，普通 Markdown 通常就够了。
Theme parameter
相关文档
Copy-paste curl
curl -X POST "https://md2wechat.com/api/v1/convert" \
-H "Content-Type: application/json" \
-H "Md2wechat-API-Key: wme_your_api_key" \
-d '{
"markdown": "# 标题\n\n正文",
"theme": "default",
"fontSize": "medium",
"convertVersion": "v1"
}'Success response
返回微信可粘贴 HTML。
Failure response
常见失败包括认证错误或 Markdown 参数不合法。
Agent notes
- 这是最适合第一次接入的接口。
- 只需要 HTML 输出的工作流优先用它。
- 如果你要接高级排版，别一上来堆很多模块，先看 Advanced Layout Recipes