模板与模块语法

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

模板：按体裁选骨架

模板库默认只保留 6 套结构模板：深度观点、教程指南、知识科普、案例复盘、干货盘点和产品发布。它们覆盖常见文章结构，不再把公告、招聘、周报等轻微差异包装成新的模板。

每套模板是一篇完整示例文章，也是一份经过策划的「文章类型 → 组件配方 → 默认主题」组合，而不是同一个骨架换名字：

• 深度观点 → 红白编辑风：导语、目录、核心判断、金句、总结、CTA
• 教程指南 → 摸鱼绿：目录、步骤、提示、检查清单、总结、CTA
• 知识科普 → 留白禅意：导语、目录、金句、轻注释、总结
• 案例复盘 → 橄榄手记：指标、时间线、核心判断、总结、CTA
• 干货盘点 → 摸鱼票据：目录、对比、清单、核心判断、总结、CTA
• 产品发布 → 石墨极简：导语、指标、步骤、升级说明、CTA

所有模板目前都可免费预览和套用；原 PRO 等级在公开模板库中作为「精选」标记展示。

主题：一键换风格

6 套精选主题决定的不只是配色，还包括封面、章节、目录、引用、列表、数据、提示和 CTA 的结构 treatment：石墨极简、留白禅意、红白编辑、橄榄手记、摸鱼绿和摸鱼票据。同一份 Markdown 切换主题时，组件会自动采用该主题的视觉语法。

不再提供独立深色主题作为发布选项。微信客户端会自行适配深色模式，再叠一套写死的深色主题会发生二次变色，真机对比度反而不可控。

模块：:::名称 指令

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

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

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

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

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

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

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

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

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

公开模块覆盖报头、导语、目录、章节、核心判断、图片、图文、引用、步骤、指标、提示、轻注释、清单、对比、总结、时间线和 CTA。模块正文只使用 字段: 值 或 | 分隔行两种格式，不要求 Agent 编写 JSON。

普通 ## 标题会按主题自动生成章节样式和编号。只有需要自定义编号、英文标签或眉题时才使用 section-title：

:::section-title[为什么判断比效率更稀缺]
number: 02
enLabel: JUDGMENT
:::

正文还支持两个语义标记，它们会自动读取当前主题样式：

• :u[关键短语]：高频关键词下划线，一段建议 1–3 处。
• :hl[核心结论]：低频高亮，只用于真正需要停顿的位置。

用量建议

普通 Markdown 仍是主干：标题、段落、列表、引用、链接和加粗都不需要模块。模块负责目录、判断、步骤、指标、对比、清单和转化等结构任务；优先沿用所选模板的配方，不随机堆叠。

**加粗** 表示语义重点，:u[] 表示段落关键词，:hl[] 表示少量核心结论。三者层级不同，不要把整段文字全部标记。

给 AI 用

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