API Overview

md2wechat Agent API 公开一个转换接口，覆盖从 Markdown 到微信可用 HTML 的主线。

当前公开能力

• POST https://www.md2wechat.cn/api/convert（备用域名 https://md2wechat.app）

请求字段：markdown（必填）、theme、fontSize、backgroundType。认证只需一把 API Key，三种等价请求头任选其一，见 Auth。

发布与能力面

• ——独立发布服务，草稿由 CLI 驱动
• 微信 IP 白名单——副作用何时需要白名单与固定出口
• 多账号发布——命名账号与显式选择
• 图片生成——供应商、预设与 plan 模式
• 标题生成——title suggest 的 handoff
• 封面图——每篇草稿的显式封面
• 排版模块目录——56 个高级排版语法名目录

共通原则

• 优先走 curl 或服务端 fetch
• 凭证放在服务端
• 从 Auth 开始看
• 从 主题目录 选当前支持的 theme 值
• 在把 theme 接进 convert 前，先看 Theme

如果你要用高级排版

这次更值得单独看的，是 convert 已经能接高级排版模块语法。

建议按这个顺序看：

1. Advanced Layout
2. Advanced Layout Syntax
3. Advanced Layout Recipes

这三页分工很清楚：

• 这套语法到底值不值得接
• 字段和模块到底该怎么写
• 面对不同内容任务，Agent 到底该选哪几个模块

如果你想少走弯路，建议再按这个顺序补三页：

1. Mode Selection
2. Advanced Layout Use Cases
3. Discovery-First Workflow