Agent API 文档API
排版模块目录
56 个高级排版语法名、9 大类与发现方式。
排版模块目录
计数契约
- 56 个推荐语法名
- 77 个推荐场景条目
- 9 个大类
- 9 种 body 格式
- 渲染层语法能力共 63 项（56 推荐 + 3 兼容模块 + 4 基础增强）
九大类
| 大类 | 代表模块 |
|---|---|
| opening | hero、toc、cards、label-title、part、section-title、epilogue、closing |
| infographic | metrics、steps、timeline、compare、infographic |
| judgment | verdict、manifesto、myth-fact、audience-fit、bridge |
| evidence | quote、image-text、image-compare、image-annotate、image-steps、gallery-grid、gallery-story、figure-caption |
| conversion | cta、faq、checklist、pricing、cases、specs、summary、toolbox、notice、logos |
| brand | author-card、people、series、subscribe |
| sprint4 | callout、changelog、comparison-table、definition、question、quote-card、resource-list、stat-row、tweet |
| free-layout | split、flow、matrix、dialogue-pair |
| interactive | svg-reveal、svg-swipe-gallery |
兼容模块（dialogue、gallery、longimage）仅用于迁移。基础增强（highlight-text、katex、mermaid、gfm-alert）在普通 Markdown 中直接渲染，无需模块语法。
九种 body 格式
| 格式 | 模块数 | 形态 |
|---|---|---|
fields | 21 | `Key |
rows | 16 | 带表头的类表格行 |
json_object | 5 | JSON 对象 |
json_array | 2 | JSON 数组 |
markdown_images | 6 | Markdown 图片列表 |
markdown_fields | 3 | Markdown 加字段行 |
split | 1 | 左右分栏 |
lines | 1 | 纯行 |
dialogue | 4 | 说话人行 |
用 CLI 发现目录
md2wechat layout list --category opening
md2wechat layout show hero
md2wechat layout render hero --var TITLE="第一屏"
md2wechat layout validate --file article.md
md2wechat capabilities --jsonlayout list 支持 --category、--serves、--content-type、--industry、--tag、--lifecycle recommended|compatibility 过滤。
目录是唯一事实源
3.0 起内置目录是唯一事实源：用户 layout YAML 覆盖已移除，未知字段与变量 fail-closed，layout validate 只做本地 schema 校验。真实渲染以 convert/preview 经 API 的结果为准。模块语法只在 API 模式渲染；AI 模式下 :::module 块按普通段落处理。