md2wechat API 支持哪些公众号主题？如何查看全部 theme 参数

如果你已经在接 md2wechat Agent API，很快就会遇到一个实际问题：

theme 到底能填哪些值？

以前很多人只能从零散示例里猜，比如先看到：

• default
• bytedance
• apple

但这对真实接入并不够，因为你还会继续问：

• 现在总共有多少公开主题
• 哪些适合知识内容，哪些适合品牌栏目
• theme 参数和编辑器里的主题是不是同一套
• 主站和编辑器应该分别去哪里看

这篇把这些问题一次讲清楚。

1. theme 参数到底是什么

theme 是 md2wechat Agent API 里用来指定公众号排版风格的参数。

它会直接影响：

• Markdown 转出来的微信 HTML 风格
• 草稿接口生成后的排版气质
• 不同内容类型的阅读节奏

也就是说，theme 不是一个装饰字段，而是排版结果的一部分。

2. 现在去哪里看全部支持的主题

现在可以直接看：

• 主题目录

这个页面展示的是当前 API 公开支持的全部主题，并且支持按分组和内容场景筛选。

它的作用不是替代编辑器，而是让你在主站里先完成这三件事：

• 确认有哪些主题可用
• 先按内容场景缩小范围
• 知道最终该把哪个 theme 值传给 API

3. /themes 和 API 文档是什么关系

这里有一个最关键的结论：

/themes 展示的主题列表，与 API theme 参数支持范围一致。

如果你准备接：

• convert
• article-draft

那么你在 /themes 里看到的主题 id，就是你真正可以传给接口的值。

对应的参数说明现在也单独放在：

• Theme 参数文档

4. 主站和编辑器怎么分工

这两个站点的分工不同：

• md2wechat.com 负责官网、文档、接入和可引用答案
• md2wechat.cn 负责编辑器和更深的主题视觉查看

所以现在更合理的用法是：

1. 先在 主题目录 里确定候选主题
2. 如果还想看更细的视觉效果，再去 md2wechat.cn
3. 最后把确认好的 theme 值传给 API

这样分工更清楚，也更适合开发者和 Agent 理解产品边界。

5. 什么时候应该优先看主题页

下面这些场景，建议先看主题目录再写请求：

• 你还没决定文章应该走哪种风格
• 你想按“知识 / 产品 / 品牌 / 运营 / 专题”筛一遍
• 你要做一批内容，希望同一栏目保持统一风格
• 你准备让 Agent 自动选主题，需要先明确候选范围

如果你已经完全确定 theme 值，只是想先跑通接口，那可以直接从：

• Quickstart
• Convert

开始。

6. 一个最小接入例子

curl -X POST "http://localhost:8080/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"
  }'

这里的关键不是例子本身，而是：

• theme 必须用当前支持的主题 id
• 这个值可以直接从 主题目录 找到

7. 如果我要接草稿接口，还看同一页吗

是。

convert 和 article-draft 用的是同一组主题值，所以你不需要为不同接口维护两套主题心智。

推荐路径是：

• 先看 主题目录
• 再看 Theme 参数文档
• 然后继续接 Article Draft

总结

如果你想知道 md2wechat Agent API 支持哪些公众号主题，最直接的入口就是：

• 主题目录

如果你想知道这些主题和接口参数是什么关系，就继续看：

• Theme 参数文档

如果你已经确定了工作流，准备开通接入，可以直接去：

• 联系页

核心结论只有一句：

/themes 是主站里的主题发现页，而你在这里看到的主题 id，就是 API 里真正可以使用的 theme 参数。