选择与主题相符的示例,核心判断只有一条:这个例子是否能让读者更准确地理解你要讲的那件事。如果例子只是“看起来相关”,却需要额外解释才能和主题挂钩,它就不适合放进正文。下面按观察、判断、处理、复查四步说明。
把候选示例逐条列出来,对每一条问两个问题:
如果第一个问题的答案是“需要我再说明一句”,说明关联是间接的。间接示例不是不能用,但它更适合放在延伸讨论里,而不是作为主要支撑。直接示例的特征是:示例里的对象、动作、结果,和主题讲的对象、动作、结果基本重合。
面对一个主题,常见的两种处理方案是:用贴近主题本身的示例,或用外围但读者熟悉的示例。两者没有绝对优劣,取决于读者基础和主题难度。
方案一:贴近主题的示例。适用于读者已经具备基本背景、主题本身有明确对象和动作的情况。判断结果是:解释成本低,但要求示例本身足够典型,不能是边角情况。
方案二:外围熟悉的示例。适用于主题抽象、读者缺乏背景的情况。判断结果是:入门更快,但必须补一句“它和主题的对应关系是什么”,否则读者会记住外围例子,却记不住主题。
假设你要说明“同义词机械换写不能带来新价值”,用一篇把“方法”全部换成“方式”的文章作例子,属于方案一,因为它和主题讲的是同一件事。假设你用“把同一句话换几种说法”作例子,属于方案二,需要补一句对应关系,否则读者可能只当成语言技巧。这里只是假设示例,不是真实项目结果。
确定方案后,按下面顺序处理候选示例:
技术类内容里,如果示例涉及标签,文字提到时应写成 <h2> 这种转义形式,避免被当成真实标签解析。这一步只影响展示,不影响示例是否与主题相符。
复查不通过时,优先删掉示例,而不是加更多解释去救它。一个需要三段话才能和主题挂钩的例子,通常不如没有。
拿你当前正在写的一段内容,把里面的示例单独抄出来,只保留主题句和示例句,看两句之间是否需要额外说明才能衔接。需要,就换或删;不需要,就保留并补上适用条件。