相关内容块：内部链接规则

相关内容块是一组位于正文末尾的短小精悍的手动选择链接集。它将读者引向最有用的下一页，并通过同一链接传递内部权威。每个目标页面都必须有编辑理由支持，仅靠共享标签是不够的。

上述渲染示例特意保持简洁。其标题说明了选择依据，每个锚文本预测了目标内容，每个理由告诉读者为什么该页面是下一步。该块不会与其所收尾的文章竞争。

为什么这个元素很重要

完成一篇有用的页面会创造出一个决策点。读者可能已经理解了当前主题，但仍需要应用它、比较选项、学习前置知识或向产品方向迈进。相关内容块减少了寻找下一步所需的工作量。它在读者准备好做出选择的时刻，提供一小套有针对性的路径，而不是要求他们返回全局导航或重新搜索。

第二个任务是架构层面的。内部权威是链接在站点各页面间帮助分配的权重和上下文相关性。链接在两个文档之间创建了一条边。其位置、锚文本和解释告诉检索系统这条边代表什么：哪个页面是宽泛的权威，哪个覆盖了子主题，哪个回答了邻近需求。

机器可提取性意味着自动化系统可以从HTML中恢复这些关系，而不必通过布局进行猜测。一个语义化的导航区域、一个可见的标题、普通的可爬取链接、描述性的锚文本以及每个目标一个条目，可以暴露出一套清晰的源–关系–目标陈述。仅依赖JavaScript的轮播、仅含图片的卡片和通用锚文本即使外观精美，也会模糊这些陈述。

这两个任务都必须经得起审查。一个能获得点击但将权威发送到无关页面的块会损害内容模型；一个正确的地图但链接无关则浪费了读者的决策点。

何时使用

当页面有两到五个可信的下一个目的地，且关系可以用一句话说明时，使用此元素。它适用于常青教育内容、商业说明文、对比内容、产品和分类页面、用例页面以及案例研究——只要另一个页面确实能推进同一任务或决策。

不要仅仅因为模板有空位就添加它。一个单用途的转化页面只有一个必要操作，可能只需要其结束行动号召。法律声明、账户页面、支持事件或短小的工具页面可能没有合理的编辑延续。一个主体部分已经由导航卡片组成的索引，不需要第二个重复的列表。

常见的近似替代方案包括：

• 标签聚合回答的是"哪些内容共享此标签？"，而非"读者下一步应该做什么？"。两篇标记为"分析"的文章可能服务于不同的受众和阶段。
• 近期文章奖励的是发布日期而非相关性。时效性对于新闻发现有用，但它不是关系模型。
• 热门文章优化的是总流量，而非当前问题。
• 底部站点地图支持广域发现，而非小范围的编辑选择路径。
• 上一篇/下一篇反映的是发布顺序。只有当该顺序本身就是有意的课程或序列时才适用。
• 行内上下文链接在需要时解释术语或支持论点。它们对此块起补充作用，但不能取代其页末决策功能。

默认情况下为手动选择。对于每个提议的链接，编辑需记录一个理由，例如"应用该方法"、“定义前置知识”、“对比此处介绍的两种选项"或"展示实践中的证据”。如果理由仅仅是"相同标签"，则删除该项。

在新闻存档、用户生成的内容集合或规模过大且变化太快而无法逐项策划的库存中，自动选择是可接受的。即使在这种情况下，也需要受控的候选集、排除当前URL和过期页面、时效性要求、超越单一标签的相关性、稳定的平局处理机制以及编辑覆盖能力。

放置位置

将块放在完整正文之后、来源块之后，但在结束行动号召之前。理由是按顺序排列的：来源关闭了当前页面的证据义务；相关内容提供下一个学习或评估路径；最终行动号召提供商业或产品路径。当页面没有来源块时，相关内容紧随最后一个实质部分。

不要在页面其他地方放置第二个相关内容块。不要将其放在重复的上一篇/下一篇导航、密集的标签云或另一个标题为"你可能也喜欢"的集合旁。一个清晰的推荐区域就足够了。

结构

渲染图例：

1. 区块标题： 命名关系，如"应用所学内容"或"比较下一个选项"。仅当目标确实涵盖不同操作时，泛泛的"相关"才可接受。
2. 项目标题： 提供描述性锚文本，预示目标页面主要价值的。
3. 目标URL： 解析为一个规范、可爬取的内部URL，不含重定向链。
4. 缩略图： 可选，当图片携带真实的识别信息时用于区分目标。
5. 单行理由： 可选，解释为什么该页面是逻辑上的下一步；当关系从标题中不明显时强烈推荐使用。
6. 区块边界： 将链接分组为导航，而不使整个卡片成为模糊的点击目标。

图例应放在页面中而非图片内部，以保持可选、可翻译并可供辅助技术使用。

设计示例

不同变体改变的是信息密度，而非编辑逻辑。

纯文本： 当目标标题能明确关系时使用的默认样式。

带理由： 适用于不同旅程阶段的默认样式。理由补充关系，而非重复标题。

带缩略图： 保留用于原始图片有助于识别的情况。图片需要尺寸和有用的替代文本，当标题已命名目标时则使用空的替代文本。

跨支柱： 明确展示文章类型、元素和业务应用之间的关系。通过审核过的前置数据生成，而非通过标签。

参数

当页面仅有狭窄、可信的选择分支时，允许使用两项。三到五项是常规范围：提供足够的选项以满足不同的下一步需求，同时每个链接保持可见和有意。六项是硬性例外，用于必须展示完整小集群的支柱页面。超过六项就变成了目录，削弱了每条边的编辑信号，并使移动端浏览变得困难。

省略的标题属性可以从项正文中的第一个标题派生。不要同时提供两个不同文本的标题。理由可以放在属性中使用简单的句子，或放在正文中需要行内强调时；不能出现两次。

语法和代码示例

规范的组件名称是related-content。嵌套的::item{}形式使每个目标页面的字段保持在一起，防止并行数组发生偏移。

可移植Markdown指令

:::related-content{heading="继续阅读手册" variant="reason"}
::item{title="编写可靠的操作指南" url="/seo-playbook/post-types/how-to-guide/" reason="将元素规则转化为完整的指导页面。"}
::item{title="构建终极指南的结构" url="/seo-playbook/post-types/ultimate-guide/" reason="将此元素与宽泛的支柱及其支持的子主题连接起来。"}
::item{title="构建用例页面" url="/seo-playbook/post-types/use-case-page/" reason="将教育意图传递到特定的受众和成果中。"}
:::

Hugo短代码

{{< related-content heading="继续阅读手册" variant="reason" >}}
  {{< item title="编写可靠的操作指南" url="/seo-playbook/post-types/how-to-guide/" reason="将元素规则转化为完整的指导页面。" />}}
  {{< item title="构建终极指南的结构" url="/seo-playbook/post-types/ultimate-guide/" reason="将此元素与宽泛的支柱及其支持的子主题连接起来。" />}}
  {{< item title="构建用例页面" url="/seo-playbook/post-types/use-case-page/" reason="将教育意图传递到特定的受众和成果中。" />}}
{{< /related-content >}}

这是一个可移植的目标约定，并不表示此仓库注册了该短代码。实际示例使用语义化HTML，不增加布局依赖。

WordPress块或短代码

<!-- wp:amicited/related-content {"heading":"继续阅读手册","variant":"reason"} -->
[related_item title="编写可靠的操作指南" url="/seo-playbook/post-types/how-to-guide/" reason="将元素规则转化为完整的指导页面。"]
[related_item title="构建终极指南的结构" url="/seo-playbook/post-types/ultimate-guide/" reason="将此元素与宽泛的支柱及其支持的子主题连接起来。"]
[related_item title="构建用例页面" url="/seo-playbook/post-types/use-case-page/" reason="将教育意图传递到特定的受众和成果中。"]
<!-- /wp:amicited/related-content -->

WordPress应使用注册的动态块，并包含嵌套项控件。短代码形式适用于无法存储嵌套块的系统，且必须在发布前注册。

示例

良好：每个链接回答不同的下一步需求

:::related-content{heading="将方法付诸实践" variant="reason"}
::item{title="执行发布前QA检查清单" url="/seo-playbook/process/checklists/pre-publish-qa/" reason="在发布前验证链接、证据、可访问性和页面结构。"}
::item{title="构建操作指南" url="/seo-playbook/post-types/how-to-guide/" reason="在完整的指导格式中应用该元素。"}
::item{title="为SaaS调整手册" url="/seo-playbook/business-types/saas/" reason="将通用规则转化为产品驱动的内容旅程。"}
:::

这个例子有效，因为目标不同但相互关联：验证、实现和业务适应。锚文本说明了每个页面的交付内容，理由解释了与当前页面的关系。

不良：标签组件伪装成编辑选择

:::related-content{heading="你可能也喜欢"}
::item{title="阅读更多" url="/blog/new-office/"}
::item{title="点击此处" url="/features/ai-visibility/"}
::item{title="最新文章" url="/blog/quarterly-roundup/"}
::item{title="SEO" url="/seo-playbook/"}
::item{title="更多SEO" url="/blog/old-seo-notes/"}
::item{title="另一篇文章" url="/academy/how-to-export-prompt-data/"}
::item{title="推荐" url="/case-studies/hz-containers/"}
:::

即使每个URL都能解析，这个示例也是失败的。七个选项超出了范围。锚文本不能预示目标内容。目标混合了公司新闻、产品、存档、学院和案例研究意图，且没有说明理由。“最新"是日期规则，“SEO"过于宽泛，没有任何内容证明这些链接服务于该读者的下一步任务。

集群约定

主题集群是一组围绕同一主题有计划的页面组。其支柱是组织该主题的宽泛页面；其分支是回答该主题局部问题的更窄页面。相关内容块将该计划转化为实际的HTML链接：

• 每个分支向上链接到其支柱。这告诉读者窄答案所属的位置，并防止分支成为孤立终点。
• 支柱向下链接到每个当前分支。当集群有超过六个分支时，使用支柱正文中的组织化章节，而非将所有内容强制放入一个相关内容块中。
• 横向链接仅在一个分支到另一个分支的关系可以被读者清晰陈述下一步时连接。共享父级是不够的。
• 当两个方向都对读者有帮助时，每条边都是双向的。反向锚文本和理由可能因旅程不同而不同。
• 删除、合并或重定向页面会触发对其所有存储边的审查。

在该手册中，文章类型页面链接到其所需的元素以及对其进行适配的业务类型。元素页面反向链接到使用它的文章类型。这些关系根据跨支柱规则从审核过的前置数据生成：本文的postTypes数组是其文章类型链接的源，而相应的文章类型元数据提供反向边。生成负责渲染；编辑仍然决定该关系是否应存在于元数据中。

更广泛的元素编写规则 规定了该元数据如何保持可移植性。切勿通过添加标签并希望组件能正确选择来修复缺失的编辑关系。

锚文本规则

锚文本是链接中可见、可点击的文字。应使其能够让读者无需阅读URL即可预测目标内容。“构建操作指南"是有用的；“阅读更多”、“点击此处”、“了解更多"以及裸露的URL则不然。

自然变化锚文本，同时保留目标主题。“创建操作指南"和"构建指导性指南"有效；不相关的关键词同义词则不行。切勿承诺目标页面不包含的模板、计算器、价格、研究或清单。

在块内，标题锚文本应保持唯一。如果两个目标会使用相同的标题，则添加能区分受众、方法或成果的内容。将可选理由放在锚文本外部，以便点击目标保持简洁，辅助技术的链接列表保持有用。

Schema标记和可访问性

不需要特殊的JSON-LD类型。JSON-LD是一种基于脚本的结构化数据格式，Schema.org是常用的共享词汇。链接通常保持为包含Article、TechArticle、Product或WebPage的一部分。不要发明RelatedContent的Schema类型。

ItemList仅在块确实是经过排序或命名的编辑列表且站点范围的Schema策略要求时，才可用于描述该块。如果使用，itemListElement必须与可见的项目顺序、URL和名称匹配。不要添加隐藏目标或合成评分。面包屑导航是另一种关系，不得吸收这些链接。

可访问性始于<nav>地标，即辅助技术可识别为导航的区域。通过aria-labelledby连接一个可见的标题；ARIA是当原生HTML本身需要帮助时，用于暴露界面名称和状态的属性集。使用<ul>，因为顺序通常不表示排名。保留可见的键盘焦点，使标题成为主要链接，并避免将交互式卡片嵌套在另一个链接内。

缩略图替代文本不得重复链接标题。对于装饰性缩略图，使用空的替代文本。当图片提供独特信息时，仅描述该信息。该块必须在禁用图片或JavaScript时保持完整，并且在推荐内容刷新时不得移动键盘焦点。

编写规则

默认使用三到五项，狭窄分支使用两项，有记录的较小集群需求不超过六项。标题2–8个词，标题锚文本3–12个词，可选理由8–22个词。理由使用一个句子、主动语态和具体关系：应用、比较、验证、定义、诊断或查看证据。

即使理由未渲染，内容模型中的每个项目也需要有独特的编辑理由。在目标页面标题更改后审查标题。使用带前导和尾随斜杠的规范内部URL。删除跟踪参数、不能识别稳定部分的片段、重定向以及返回当前页面的链接。

切勿在此元素内放置广告、作者简介、社交关注按钮、订阅表单、标签云、无关推广或来源引用。不要将外部阅读与内部下一步混在一起；外部证据属于来源块。不要使用"最佳”、“热门"或"推荐"等徽章，除非页面定义并支持其选择依据。

语气应有益且具体，而非紧迫。避免"必读”、“不容错过”、人为的稀缺性以及声称目标是全面的（除非其范围确实支持该说法）。该块推荐一条路径；它不会制造重要性。

使用该元素的文章类型

前置数据中的postTypes数组是以下跨支柱关系的真实来源。

并非每个候选页面都需要在每页上渲染。文章类型定义了符合条件的关系；页面编辑选择对实际主题和旅程有意义的目标。

QA检查清单

• 块出现一次，在来源之后、结束行动号召之前。
• 页面包含二到五个链接，或使用六个的有记录原因。
• 每个项目都有记录的编辑理由，超出共享标签、分类或发布日期。
• 每个锚文本预测目标实际交付的内容，避免"阅读更多”、“点击此处"及类似的通用语言。
• 集合支持集群约定：分支向上、支柱向下，仅当真正相关时横向链接。
• 排除当前URL，目标为规范链接，无链接依赖重定向或跟踪参数。
• 相关内容前置数据与渲染的跨支柱链接一致。
• 该块在无缩略图或JavaScript的情况下仍可读、可导航、完整。
• 导航区域有可见标题和可访问名称；键盘焦点可见。
• 缩略图存在、增加识别价值、预留尺寸、使用正确的替代文本。
• 理由增加下一步关系而非重复标题。
• 来源、广告、表单、社交链接和无关推广保持在块外部。
• 任何ItemList结构化数据与可见项目和顺序完全匹配。
• 移动端渲染使每个标题和理由可见，无隐藏水平轮播。

审核者应拒绝仅仅是"说得通"的链接。每个链接必须是正确的下一步，表达真实的架构边，并在HTML中保持清晰。

常见问题

学院模板从前置数据中渲染FAQ条目。