56 个高级排版模块使用指南

目录里有 56 个推荐语法名，分 9 大类，77 个推荐场景条目，渲染层语法能力共 63 项。完整目录。

按任务看九大类

• 开场（hero、toc、cards、label-title、part、section-title）：第一屏决定值不值得读。
• 信息图（metrics、steps、timeline、compare）：压缩结构化事实。
• 判断（verdict、manifesto、myth-fact、audience-fit、bridge）：给读者留下一个观点。
• 证据（quote、image-text、image-compare、gallery-grid、figure-caption）：让主张可核对。
• 转化（cta、faq、checklist、pricing、cases）：落好下一步动作。
• 品牌（author-card、people、series、subscribe）：跨文章的重复身份。
• Sprint4（callout、changelog、comparison-table、definition、question、quote-card、resource-list、stat-row、tweet）：快速小单元。
• 自由布局（split、flow、matrix、dialogue-pair）：分栏与流程。
• 互动（svg-reveal、svg-swipe-gallery）：仅 SMIL 动画，无 JS。

九种 body 格式

模块体是 9 种格式之一——fields（21 个模块）、rows（16）、json_object（5）、json_array（2）、markdown_images（6）、markdown_fields（3）、split、lines、dialogue。写模块体之前先查格式：

md2wechat layout show hero
md2wechat layout render hero --var TITLE="第一屏"

少即是多

一篇文章一个 hero、至多一个判断模块、至多一个转化块，通常好过全部堆上。先从 CLI 发现、本地校验，再经 convert/preview 证明渲染：

md2wechat layout validate --file article.md
md2wechat convert article.md --preview

目录是唯一事实源

3.0 起用户 layout YAML 覆盖已移除，未知字段 fail-closed。兼容模块（dialogue、gallery、longimage）仅用于迁移；基础增强（highlight-text、katex、mermaid、gfm-alert）无需模块语法直接渲染。