模板与模块语法

wexin 的排版能力由三层组成：模板（文章的结构骨架）、主题（视觉风格）、模块（可插拔的结构组件）。这一页讲清三者的关系和写法。

模板：按体裁选骨架

模板库目前有 24 套模板，覆盖公众号常见体裁：产品发布、教程指南、知识科普、案例复盘、横评、研报、访谈、年度盘点、好物书单、读书笔记、活动预告、团队周报、招聘、课程招生、产品更新……

每套模板就是一篇完整的示例文章：报头怎么起、小标题怎么分、金句放哪、结尾怎么收，都已经排好。用法是替换而不是创作——把示例文字换成你的内容，结构和样式自动保留。

部分标注 PRO 的模板可以免费预览，开通 Pro 后套用。

主题：一键换风格

14 套主题决定配色与视觉细节，多数主题有独立设计的深色版本。同一篇文章可以随时切换主题对比效果——内容不动，风格全换。

为什么深色要"独立设计"而不是自动反色？因为公众号会剥离外部样式表和媒体查询，深色必须是一套写死的具体配色才能在后台存活。

模块：:::名称 指令

在标准 Markdown 之上，wexin 增加了一类块级指令，语法是：

:::模块名[主参数]
字段名: 值
:::

注意模块名后的冒号、方括号都是英文符号。常用模块：

报头（hero）——文章开头的标题区：

:::hero[Canvas 2.0 正式发布]
subtitle: 我们重写了协作白板的内核，让 50 人同屏不再卡顿
:::

金句（quote）——突出显示一句话：

:::quote[工具的本分，是把重复的事收走，把决定权留下。]
:::

行动按钮（cta）——文末转化区：

:::cta[现在就升级到 Canvas 2.0]
desc: 所有团队免费升级，数据无需迁移。
button: 立即开通|https://example.com
:::

其他可用模块还有 metrics（数据卡）、steps（步骤条）、timeline（时间线）、faq（问答）、compare（对比表）、checklist（清单）、figure / image-text（图文）等。

用量建议

模块是调味料，不是主食：一篇文章 3–6 个模块就够，正文主体仍然用普通 Markdown 段落。开头一个 hero、中间最多一个金句或一个结构组件、转化型文章结尾加一个 cta——这正是 24 套内置模板的统一写法。

给 AI 用

通过 MCP 接入的 AI 助手可以调用 list_templates、get_template、list_modules 等工具拿到完整目录和每个模块的精确语法，不需要人工传授。