Theme

theme 是 md2wechat Agent API 用来指定公众号排版风格的参数。无论是 Markdown 转微信 HTML，还是直接创建可审核草稿，都会用到它。

这页解决什么问题

• /themes 展示的就是当前公开支持的 theme 列表
• 这组主题 id 用于 convert 接口
• md2wechat.com 是官网、文档和接入入口
• md2wechat.cn 是同一组主题的编辑器深度查看入口
• 如果 md2wechat.cn 暂时不可用，可改用编辑器备用域名 md2wechat.app

如何选主题

可以从这几个维度判断：

• 内容类型：知识、产品、专题、品牌、运营
• 阅读节奏：更轻还是更高信息密度
• 对比强度：更柔和还是更强调
• 发布流程：只是转 HTML，还是要进一步创建公众号草稿

建议先去 /themes 按场景筛一遍，再把最终确认的 theme id 带进接口。

请求示例

{
  "markdown": "# 标题\n\n正文",
  "theme": "default",
  "fontSize": "medium",
  "backgroundType": "default"
}

48 套主题分组

模式匹配

主题带 type: api 或 type: ai 标记。API 模式只能选 api 主题，AI 模式只能选 ai 主题——加载器对不匹配 fail-closed（THEME_MODE_MISMATCH）。

每主题元数据

每个主题带语义元数据：bestFor（适合场景）、mood、density（light/balanced/dense）与 contrast（soft/medium/strong）。预览前可先用这些字段缩小范围。

推荐使用路径

1. 先在 /themes 里按场景缩小范围
2. 如果还要看更细的视觉效果，再去 md2wechat.cn 查看对应主题；如主域名不可用，可改用 md2wechat.app
3. 确认后，把同一个 theme id 传给 Convert
4. 如果还没开通，继续去 联系页