md2wechat很多公众号文章的问题是信息密度太高。
读者在手机上扫读时，最先丢掉的是判断：
- 这段到底提醒我什么？
- 这一句为什么值得记住？
- 这个数字是不是核心结果？
callout、quote-card、stat-row 解决的就是这三件事。
它们把正文里最容易被跳过的信息变成阅读停顿点。
先记住分工
这三个模块不要混用：
callout：提醒、风险、前提、注意事项。quote-card：一句判断、品牌主张、用户反馈。stat-row：一组关键数字或指标。
如果你不知道该用哪个，先问一句：
我是想提醒读者，还是想让读者记住一句话，还是想让读者先看到结果？
答案分别对应 callout、quote-card、stat-row。
callout 适合提醒，不适合喊口号
callout 最适合放在正文中间，用来提示读者某个前提或风险。
:::callout
{"type":"warning","title":"发布前先检查","body":"如果文章里用了图片模块，先确认图片链接可以公开访问，否则复制到公众号后台后可能无法正常显示。"}
:::
适合：
- 发布前提醒
- 不适用场景
- 操作风险
- 关键前提
- 读者容易误解的地方
不适合：
- 长篇解释
- 重复标题
- 把每个段落都包装成提醒
quote-card 适合放一句真正值得记住的话
quote-card 不是普通引用。它更适合品牌主张、用户反馈、文章核心判断。
:::quote-card
{"quote":"好排版让读者更快找到判断、证据和下一步。","author":"md2wechat 内容设计原则","role":"公众号排版系统"}
:::
最稳的写法是：
- 一句话不要太长
- 作者或来源要可信
- 不要连续堆叠多个
quote-card
如果这句话不能单独截图转发，就不要用 quote-card。
stat-row 适合一眼看到结果
当你有一组数字时，不要埋在正文里。
:::stat-row
[{"value":"47","label":"高级模块名"},{"value":"48","label":"主题数量"},{"value":"2.7k","label":"md2wechat-skill GitHub Star"}]
:::
适合：
- 产品成果
- 数据摘要
- 活动复盘
- 增长结果
- 方案亮点
注意：
- 3 个数字最稳
- 每个数字都要有标签
- 不要把普通文字硬塞成数字
三个模块怎么组合
教程型文章
推荐顺序：
callout提醒前提stat-row展示结果quote-card总结判断
示例节奏：
:::callout
{"type":"info","title":"先看前提","body":"下面的模块示例默认用于公众号窄屏阅读，不建议直接照搬到宽屏网页。"}
:::
:::stat-row
[{"value":"3","label":"核心模块"},{"value":"10 分钟","label":"上手时间"},{"value":"1 篇","label":"先改一篇文章"}]
:::
:::quote-card
{"quote":"先让读者看懂，再让页面好看。","author":"md2wechat","role":"高级排版系统"}
:::
产品更新文章
推荐顺序：
stat-row先给更新结果callout提醒升级影响quote-card放版本判断
企业服务文章
推荐顺序：
callout说明适用对象stat-row给交付指标quote-card放客户反馈
常见错法
错法一：把 callout 当大标题
提醒模块不是标题模块。标题负责开新段，callout 负责提醒风险和前提。
错法二：quote-card 里塞一整段话
金句卡应该像一句能被读者带走的话，不应该变成另一个段落。
错法三：stat-row 只有数字，没有解释
数字本身没有意义。读者真正记住的是“这个数字说明了什么”。
给 Agent 的提示词
如果你让 Agent 自动排版，可以这样要求：
请检查正文中是否有提醒、风险、关键判断和数字结果。
提醒或风险用 :::callout。
一句核心判断用 :::quote-card。
三个以内关键数字用 :::stat-row。
不要连续堆叠同类模块。
下一步
如果你的文章还需要术语解释、用户反馈和问答结构，可以继续读：