Advanced Layout Mistakes

第一次接高级排版，最常见的问题不是不会写语法，而是用错地方、用太多、或者把任务判断错了。

错误 1：内容还没想清楚，就先堆模块

如果你还没想清楚这篇要完成什么，模块越多，文章越散。

先判断：

• 这是发布稿、教程、方法论还是服务页
• 读者最先该看到什么
• 最后希望读者做什么

错误 2：一篇里用太多重模块

很多人一看到模块多，就想都试一遍。

结果通常是：

• 节奏被打碎
• 正文像一堆卡片
• 重点反而不明显

多数文章控制在 3 到 6 个模块就够了。

错误 3：把开场写成摘要大全

开场的任务不是把整篇都讲完。

开场更该做的是：

• 告诉读者值不值得继续看
• 给出一个判断
• 交代接下来会讲什么

错误 4：把所有正文都塞进模块里

高级排版不是要消灭普通正文。

很多时候，普通段落才是最自然的承载方式。模块应该用在需要分层、对比、强调和收尾的地方。

错误 5：只看样子，不看动作

看起来更丰富，不等于更有用。

如果一篇文章读完以后：

• 记不住你的判断
• 不知道下一步做什么

那结构还是没收住。

错误 6：没跑 discovery，就先假设可用能力

这对 Agent 特别常见。

先看：

md2wechat capabilities --json
md2wechat layout list --json
md2wechat layout show hero --json

先确认当前能力，再写规则，会稳很多。

错误 7：把高级排版当成所有内容的默认选项

不是每一篇都需要它。

短消息、简单通知、轻内容更新，很多时候普通转换更合适。

一个更稳的做法

每次都按这个顺序来：

1. 先判断内容任务
2. 先选一个开场模块
3. 再选一到两个正文模块
4. 最后选一个收尾模块

继续看

• Advanced Layout Use Cases
• Advanced Layout Syntax
• Discovery-First Workflow