跳到主要内容

模块教程 / FIELD NOTES

术语、社交证明和问答怎么排?definition、tweet、question 三个模块的用法

术语解释、用户反馈和常见问题,本质上都在降低理解成本。definition、tweet、question 适合把这些内容从正文里拎出来,让读者更快建立信任。

知识型文章和产品说明最常见的三个问题是:

  • 读者不理解某个概念
  • 读者不相信你的判断
  • 读者心里还有疑问

definitiontweetquestion 分别解决这三个问题。

它们的共同目标是降低理解成本。

三个模块的分工

  • definition:解释一个术语或概念。
  • tweet:引用一条用户反馈或社交证明。
  • question:整理读者可能会问的问题。

如果一篇文章要让读者更快理解、更愿意相信、更少犹豫,这三个模块非常值得放进中段。

definition:让术语不再打断阅读

当你必须使用专业词时,不要在正文里绕很长一段解释。

:::definition
{"term":"GEO","def":"Generative Engine Optimization,面向 AI 搜索和 AI 答案引擎的内容优化方式,重点是让内容更容易被理解、引用和推荐。"}
:::

适合:

  • 技术术语
  • 方法论名词
  • 产品概念
  • 行业缩写

注意:

  • 只解释一个概念
  • 不要写成百科长文
  • 最好用一句话讲清楚它和读者有什么关系

tweet:把真实反馈变成信任证据

tweet 不一定只用于推文。它本质上是“短反馈引用卡”。

:::tweet
{"name":"一位内容团队负责人","handle":"@content-lead","text":"以前每篇公众号都要反复调样式,现在只要先定模块结构,文章看起来稳定很多。","timestamp":"2026-06-03"}
:::

适合:

  • 用户反馈
  • 社交媒体摘录
  • 客户评价
  • 社群评论
  • 内部复盘金句

注意:

  • 不要伪造来源
  • 不要写得像广告语
  • 反馈越具体越可信

question:把疑问集中处理

如果读者读到一半会犹豫,可以提前用 question 承接。

:::question
Q: 这些模块需要懂设计才能用吗?
A: 不需要。你只需要判断内容属于开场、证据、说明还是行动,再选择对应模块。
Q: 模块越多文章越高级吗?
A: 不是。模块应该解决阅读问题,连续堆叠只会让文章更累。
:::

适合:

  • FAQ
  • 课程介绍
  • 产品说明
  • 服务介绍
  • 读者疑虑

三个模块怎么放进一篇文章

教程文章

推荐顺序:

  1. definition 解释新概念
  2. question 回答初学者疑问
  3. resource-list 放延伸资料

产品文章

推荐顺序:

  1. definition 解释产品能力
  2. tweet 放真实反馈
  3. question 回答购买前顾虑

观点文章

推荐顺序:

  1. definition 限定讨论范围
  2. tweet 引用外部反馈
  3. quote-card 提炼核心判断

结构化写法注意事项

这三个模块都偏结构化,但输入位置不同:definitiontweet 使用标准 JSON;question 只使用大写 Q: / A: 成对文本。

最常见错误有三类:

  • 字符串缺少引号
  • 数组结尾多逗号
  • question 使用了小写前缀,或问题与回答没有成对出现

给 Agent 的提示词可以这样写:

请用合法 JSON 输出 definition 和 tweet 模块,字段名使用英文双引号。
question 模块只写一组或多组大写 Q: / A:,不输出 JSON。
不要混用两种输入位置。

常见错法

definition 写成小论文

术语卡只负责“让读者继续读下去”,不是负责讲完全部背景。

tweet 写成品牌广告

可信反馈应该具体、有场景、有人的语气。

question 放到文章最后才出现

如果疑问会影响读者继续阅读,就应该提前出现,不一定等到结尾。

下一步

如果你要做方案选型、版本更新或资源合集,可以继续读:

继续阅读

公众号高密度内容怎么排?callout、quote-card、stat-row 使用指南

如果正文信息很多,但读者看完记不住重点,先不要继续加大标题。callout、quote-card、stat-row 更适合把提醒、判断和关键数字变成清楚的阅读停顿点。

选型、更新日志和资源合集怎么排?comparison-table、changelog、resource-list 用法

产品文章最容易写散:一会儿讲对比,一会儿讲更新,一会儿丢链接。comparison-table、changelog、resource-list 能把这三类信息整理成读者可收藏的结构。

自由布局模块怎么用?split、flow、matrix、dialogue-pair 的最新推荐语法

自由布局用来处理复杂内容。split 负责左右信息,flow 负责短流程,matrix 负责多方案对比,dialogue-pair 负责双人视角。

YOUR NEXT ARTICLE

让下一篇文章,从清楚的排版开始。

先看效果,再把稳定的排版能力接入你的工作流。

术语、社交证明和问答怎么排?definition、tweet、question 三个模块的用法