split、flow、matrix、dialogue-pair 是最近最容易被误用的一组模块。
原因很简单:它们看起来像“布局模块”,但真正解决的是复杂内容表达问题。
split:左右两块信息需要并置。flow:短流程需要一眼看完。matrix:多方案多能力需要比较。dialogue-pair:双人视角需要来回解释。
split:并置信息
split 适合左右内容都比较短、互相补充的场景。
:::split[3:2]
## 左栏:核心判断
高级排版让读者更快找到重点。
---
## 右栏:适用场景
- 发布稿
- 教程稿
- 企业服务稿
:::
注意:
- 左右内容都不要太长
- 中间用
---分隔 [3:2]表示左右比例- 手机上会更重视纵向阅读,不要依赖复杂桌面布局
flow:最新推荐用箭头或列表
flow 适合短流程,不适合每一步都写长解释。
推荐写法:
:::flow[产品上线流程]
需求分析 → 设计评审 → 开发联调 → 测试验收 → 正式发布
:::
也可以用列表:
:::flow[内容发布流程]
- 写草稿
- 选模块
- 预览检查
- 发布草稿
:::
不推荐把每一行写成“标题 | 说明”。如果需要长说明,请用 steps。
matrix:必须使用 headers=
matrix 适合多方案、多能力对比。
推荐写法:
:::matrix headers=能力,基础版,专业版,企业版
高级模块|✓|✓|✓
主题定制|✗|✓|✓
API 调用|✗|✓|✓
私有部署|✗|✗|✓
:::
注意:
headers=是必填字段;缺少时整块不渲染,也不会把原始数据行回退成正文- 数据行用
| - 不要写标准 Markdown 表格分隔行
|---|---| - 不要在每行首尾额外加竖线
如果只比较两个方案的优劣,请用 comparison-table。
dialogue-pair:用 left= 和 right=
dialogue-pair 适合双人视角,不是普通聊天气泡。
推荐写法:
:::dialogue-pair left=读者 right=作者
U: 高级模块和普通 Markdown 有什么区别?
E: 高级模块把结构内联到样式里,微信公众号也能完整渲染。
U: 我需要先学多少个模块?
E: 先学开场、信息卡、证据和收尾四类,已经能覆盖多数文章。
:::
注意:
- 人物名用
left=读者 right=作者 - 左侧发言用
U: - 右侧发言用
E: - 不推荐写
:::dialogue-pair[读者 | 作者]
四个模块怎么选
你要并置两个信息块
用 split。
你要展示短流程
用 flow。
你要比较多列能力
用 matrix。
你要做读者和作者问答
用 dialogue-pair。
给 Agent 的提示词
请根据内容选择自由布局模块:
两个短信息块用 split。
3-6 个短流程节点用 flow,优先用箭头写法。
多方案多能力对比用 matrix,必须使用 headers=。
双人视角问答用 dialogue-pair,必须使用 left= 和 right=。
不要使用旧的 dialogue-pair[读者 | 作者] 写法。
常见错法
split左右两栏都写成长文flow每一步都写一大段说明matrix写成标准 Markdown 表格dialogue-pair忘记写left=和right=
自由布局让复杂内容更好读。
下一步
如果你想把中段做成更强的视觉摘要,可以继续读: