要点摘要框：格式与示例

要点摘要框呈现三到五个读者即使未从头到尾阅读页面也应记住的结论。每个项目符号都是一个完整、独立可用的陈述——而非关于文章将涵盖内容的承诺。

这个实时示例使用现有的Academy标注处理方式展示预期的层级结构：可见标签后跟随一个简短、有边界的列表。规范元素仍为key-takeaways；视觉样式不得改变其编辑目的。在将其在不同发布系统间迁移时，应用共享的元素编写规则 。

为什么这个元素很重要

读者很少对每个页面进行线性阅读。他们会检查标题、开头、标题、列表和可见证据来决定页面是否值得更多关注。要点摘要框立即回报了这种扫读。扫读者无需长滚动就能获得页面的实际价值，而仔细阅读的读者则获得一个用于解读后续证据的心理模型。由于项目符号陈述的是结论而非主题，它们还能揭示文章是否有实质性的内容可说。

这种读者收益依赖于压缩，而非简化。像"当关键信息缺失于初始HTML时，使用服务端渲染的产品详情"这样的结论保留了其决策和条件。而仅仅"渲染"则不能。一个好的项目符号减少了阅读工作量，同时保留了使主张准确的主体、主张和边界。

同样的边界也有助于机器。排名系统是根据查询对文档进行排序的软件；密集的开篇摘要为其提供了页面实际声明的简洁表示。检索系统是选择段落或文档用于搜索结果或生成答案的软件；几个自包含的项目符号为其提供了可独立引用的段落。这并不是承诺该框会带来排名或引用。它使文章的含义更易于识别和复用，而无需系统从多个相距甚远的段落中重建结论。

机器可提取性意味着该区块及每个条目的含义在脱离页面设计或周围散文时仍能保持。这就是为什么像"这个"这样的代词、“更好的性能"这样的片段以及无解释的超级形容词会失败。即使边框、图标和章节顺序消失，文字也必须承载含义。

何时使用

当一篇文章页达到至少三个对读者决策或理解有意义的独特结论时，使用要点摘要框。该元素在以下情况下最有价值：包含多个章节的指南、具有多个决定性发现的对比文章，或证据支持紧凑结论集合的研究性文章。即使草稿版本指导了提纲，也要在正文完成后编写最终框，因为只有完成的文章才能证明哪些内容可以安全地总结。

当页面只有一个答案时不要使用它。改用直接答案块 。不要用它来预览序列、列出章节或帮助读者导航；那是快速概览与目录 的工作。简短的术语表定义、狭窄的产品功能或大约700字以下的文章通常不需要将自身重新表述为项目符号。

接近误判的情况需要明确处理：

• 主题列表是概览，即使其标题写着"关键要点”。
• 操作列表是清单或步骤列表（当完成很重要时）；结论不会仅仅因为以动词开头就变成行动。
• 一组统计数字不是要点摘要框，除非每个数字都支持一个陈述的发现，且其分母、时期和范围都存在。
• 一组好处是营销文案，当正文没有展示这些好处时。
• 对某个长章节的回顾可以使用该元素的章节变体，但仅当该章节产生三个或更多值得保留的结论时。

放置位置

位置告诉读者该框总结什么。默认的文章级变体出现在一到两段引言之后，通常在前150个词以内、第一个实质性H2之前。引言指明主题和范围；框再陈述结论。在任何背景之前放置框会迫使每个项目符号携带笨拙的铺垫，而将其放在几个章节之后则违背了其扫读目的。

切勿在框内放置销售行动号召，或将其直接附加到最后一个项目符号上。该框承诺编辑压缩；将该承诺与转化文案结合会使结论看起来是为促成点击而选定的。

结构分析

该元素有五个有意义的区域。标签命名该区块。可选的标题缩小其范围，如"基准测试结果显示"。列表确立各结论是并列关系。每个条目包含主体、结论和必要的限定词。周围的范围关系——文章开头、章节结尾或页面结尾——定义了条目总结的内容。

渲染图例：

1. 标签： 始终将元素标识为"关键要点"或经批准的通俗语言等效词，如"概要"。
2. 可选标题： 在无需重复标签的情况下命名有边界的主体。
3. 列表容器： 容纳三到五个无序、权重相同的结论。
4. 独立条目： 用明确的主语和动词陈述一个主张。
5. 限定词： 保留相关的受众、时期、条件、度量或例外。
6. 范围关系： 显示该框是总结文章、前一个章节还是整页结论。

截图标注标识的是语义区域而非像素。边框粗细、图标、背景和间距可能随设计系统变化；标记的结构必须保留。

设计示例

共有三种编辑变体。它们的区别在于范围和位置，而不仅仅是颜色。

文章顶部变体： 用于长指南、对比文章和以证据为主导的页面。未修改的标签"关键要点"通常已足够，因为整个页面提供了范围。

章节末尾回顾： 在包含多个需要读者综合的发现的较长章节之后使用。标题必须命名该章节的主体，条目不得声称总结后续章节。

结尾总结： 当论点在整页中逐步累积且早期结论尚不成熟时使用。当开篇框已陈述相同发现时不要添加。行动号召在总结之后仍保持为独立元素。

参数

这些参数构成一个编辑界面，因此限制适用于Markdown、Hugo和WordPress，而非针对某一个渲染器。

12–30个词的条目区间之所以存在，是因为项目符号需要足够的空间容纳完整的主张及其范围，同时又必须比支持它的段落更容易快速扫读。合法的限定词可能将条目推至35个词。超过此限制时，修改主张或将解释移至正文中。

语法与代码示例

所有三种标记法编码相同的标题、变体和四个条目。平台适配器可能会更改标记，但不得将列表扁平化为无类型的段落，也不得从任意标题推断结论。

可移植Markdown指令

:::key-takeaways{variant=article-top title="Key takeaways"}
::item
在我们测量的10个垂直领域中，分类页面在头部关键词上排名优于产品页面。
::
::item
当查询指定特定型号、尺寸或配置时，产品页面仍然是更强的目标页。
::
::item
每个已发布的对比都必须保留支持性分析中使用的测量周期和垂直范围。
::
:::

Hugo短代码

{{< key-takeaways variant="article-top" title="Key takeaways" >}}
- 在我们测量的10个垂直领域中，分类页面在头部关键词上排名优于产品页面。
- 当查询指定特定型号、尺寸或配置时，产品页面仍然是更强的目标页。
- 每个已发布的对比都必须保留支持性分析中使用的测量周期和垂直范围。
{{< /key-takeaways >}}

WordPress区块或短代码

[key_takeaways variant="article-top" title="Key takeaways"]
- 在我们测量的10个垂直领域中，分类页面在头部关键词上排名优于产品页面。
- 当查询指定特定型号、尺寸或配置时，产品页面仍然是更强的目标页。
- 每个已发布的对比都必须保留支持性分析中使用的测量周期和垂直范围。
[/key_takeaways]

这些示例是实施合同，而非关于AmICited数据的声明。仅在文章正文命名了十个测量的垂直领域、测量周期、查询集和支持该结果的证据时，才能发布"10个中的8个"这一陈述。

示例

良好：正文可以支持的结论

关键要点

• 在我们测量的10个垂直领域中，分类页面在头部关键词上排名优于产品页面。
• 产品页面执行不同功能：它们回答特定型号的查询并支持直接购买决策。
• 团队只有在确认搜索结果回报分类级别意图后，才应将头部关键词映射到分类页面。

这之所以有效，是因为每个条目都有主语和结论。第一个保留了测量的范围，第二个解释了不同的角色，第三个将证据转化为有边界的决策。每个主张都可以在正文中找到并得到支持。

糟糕：披着要点摘要框外衣的目录列表

关键要点

• 在本文中，您将了解X、Y和Z。
• 我们将涵盖分类页面和产品页面。
• 继续阅读以发现我们的优化技巧。

这之所以失败，是因为项目符号描述的是文章本身，而非其发现。它们没有提供扫读者可以使用的结论，也没有提供检索系统可以引用的主张。“继续阅读"也是一种推广性指令，而非要点。在正文完成后用实际结论替换列表，或者当引导才是真正目的时将其重新标注为概览。

与直接答案和结论的关系

如果三个元素的工作没有明确区分，它们可能会重叠。直接答案用一个紧凑段落解决主要问题。关键要点保留三到五个来自证据的不同结论。总结或结论在读者看过证据后综合论点，并可能解释影响，但默认情况下它不是第二个项目符号列表。

使用这个消除歧义规则：每个主张在顶部附近有一个主要归属地。如果直接答案已经陈述了唯一结论，则省略要点。如果要点添加了不同的发现，保持直接答案专注于主要问题，并且不在第一个项目符号中重复其措辞。如果开篇框已经捕捉了完整的综合，则使用结尾部分处理影响或后续步骤，而不是重复所有项目符号。永远不要仅仅因为模板提供了槽位就同时发布所有三个。

Schema标记与无障碍访问

关键要点框没有专用的Schema.org类型或JSON-LD属性。JSON-LD是用于结构化数据的机器可读格式；该元素仍然是包含它的Article、TechArticle或其他有效页面类型的一部分。不要仅仅为了创建额外的结构化数据而将其项目符号映射到HowToStep、FAQPage或ItemList。这些类型暗示着流程、问答或可能不匹配编辑含义的列表。

HTML应暴露一个包含真实无序列表的已标记区域。当可见标题是标题时，使用aria-labelledby将其连接到区域；ARIA是一组将界面角色和关系传达给辅助技术的属性。如果不存在标题，可以使用如aria-label="关键要点"这样的可访问名称。不要添加role="alert"：内容不是时间敏感的，不应中断屏幕阅读器用户。

每个条目必须在文档顺序中无需颜色、图标或附近散文即可理解。保持链接描述性强且精简。键盘用户应仅遇到普通链接；该框不需要展开/折叠控件，除非更广泛的设计系统以无障碍方式提供了控制，且默认隐藏主要摘要并不推荐。

编写规则

该框包含三到五个项目符号。每个项目符号是完整的独立陈述，通常12–30个词，且不超过35个词。以主语开头，直接陈述结论，并包含保证准确性所需的最小限定词。使用句子大小写和结尾标点。当有助于提高扫读效率时保持平行语法结构，但不要强迫每个主张都使用相同的措辞。

仅以正文证据的强度进行断言。“在启用服务端缓存后，测量的页面加载速度更快"在有方法和前后数值出现于下方时是可以支持的。“缓存总能改善排名"则不可。“也许这可能会有帮助"这样的模糊表达并不能修复薄弱的证据；它只会模糊主张。如果正文无法支持有用的结论，则删除该项目符号。

切勿包含：

• 行动号召、注册链接、销售优惠或"继续阅读"提示；
• 主题、章节名称或关于读者将学到什么的承诺；
• 正文中不存在的事实、数字、推荐或因果主张；
• 无支持的超级形容词，如"最佳”、“最快"或"最重要”；
• 回避结论而非陈述诚实限制的模糊填充词；
• 过于冗长以至于主导条目的引文；将详细的来源注释保留在支持性正文主张处；
• 嵌套列表、表格、图片、程序、FAQ或其他标注。

这些排除项的原因在于信任。该框通过准确压缩文章来赢得突出地位。任何推销、预览、装饰或超出证据的内容都会破坏这一承诺。

使用此元素的文章类型

postTypes前端变量是此映射的来源。未在其中列出的文章类型不应仅仅因为其他页面使用了该元素就继承它。

QA检查清单

审阅者在检查装饰细节之前先核对编辑合同：

• 框包含三到五个项目符号，每个项目符号是完整句子，位于12–30个词的区间内，或具有合理的限定词最多35个词。
• 每个条目陈述的是结论，而非主题、章节名称、学习承诺或程序中的操作。
• 正文明显支持框中的每个主张、数字、比较、范围和推荐。
• 每个条目在脱离框、标题或周围段落被复制时仍保持准确和可理解。
• 框出现在允许的位置，其范围——文章、章节或结尾综合——是明确的。
• 附近的直接答案、概览、目录或结论不重复相同信息。
• 内部没有行动号召、销售信息、无支持的超级形容词、回避性模糊表达、嵌套组件或未验证的统计数据。
• 渲染输出具有可见文本标签和语义无序列表；颜色和图标不是唯一的标识符。
• Markdown、Hugo和WordPress表示保留相同的变体、标题、条目顺序和措辞。
• 截图注释保持为注释，直到命名的真实截图存在；不渲染不存在的图片路径。

当某项失败检查改变了框的含义或可信度时，应拒绝该框。审阅者可以直接修正标点，但无支持的主张必须退回给作者或证据持有者。

常见问题

常见问题