标题、列表与代码块承担扫描锚点
别名: 语义扫描锚点 · 文档结构 · 标题层级 · accessible documentation structure
概念解释
文档中的语义扫描锚点（semantic scan anchors in documentation）用结构类型表达内容关系，让读者在视觉或辅助技术中定位：标题命名层级与主题，编号列表表达顺序，无序列表表达并列，代码块标识可执行或可复制的字面内容，表格对齐需要比较的字段。锚点不是单纯的高对比造型，也不是把所有段落改成圆点；应按信息关系选择结构，并保留散文承担条件、因果和论证。
搜索落点和深链也是锚点的一部分。跳转应到达有名称的语义节点，让视觉焦点、键盘焦点和读屏上下文都能确认“到了哪里”。
机制
扫描依赖可预测的差异。标题帮助匹配问题或任务，列表暴露次序与并列，代码块让字面值从解释中分离，表格支持沿行列比较；若结构与关系一致，读者无需先读完整段落就能选择下一步。反之，仅靠字号和颜色模拟标题不会进入读屏标题列表；把条件分支拆成若干圆点可能丢失逻辑；用代码块强调普通文字会误导复制行为。
锚点还形成机器可用结构：搜索索引可把查询指向小节，目录可从标题树生成，深链可引用稳定节点，辅助技术可按语义类型跳转。显示文字、DOM 或原生语义、锚点标识和搜索索引若不同步，视觉上看似清楚的页面仍可能产生错误落点或无上下文朗读。
怎么研究
从真实查询与任务抽样，让参与者经搜索结果或深链进入页面，定位一个步骤、参数、比较项或解释。比较纯散文、视觉造型但无语义、以及语义结构版本，记录首次正确落点、标题或控件跳转、答案准确、误复制、回退和完成时间。任务应包含需要连续推理的材料，以检验列表化是否破坏理解，而不只测试短事实查找。
在窄屏检查表格横向滚动、代码换行和标题层级；在键盘与读屏中检查标题列表、列表计数、表头关联、代码朗读、复制控件名称与深链后的焦点。自动可访问性检查能发现缺少标题或表头，但不能证明标题有信息量、列表类型正确或表格适合该关系，仍需人工任务验证。
边界
段落不是失败的锚点。解释原因、描述条件交互和展开论证时，连贯散文通常比碎片列表更准确。一个列表项中若含多个段落或复杂分支，应考虑子标题、表格或散文；表格只适合有一致维度的比较，移动端或读屏难以理解时可改为逐项结构或提供等价呈现。
代码块应承载代码、命令、配置或必须保持字面格式的内容，并在块外说明前置条件、环境和后果。标题不必全部写成问句；准确、可区分、与用户词汇相接的名词或任务标题同样有效。视觉显著性可以帮助扫描，但不能替代正确层级和程序语义。
怎么落地
- 先标注信息关系，再选结构：步骤用有序列表，并列项用无序列表，术语与定义用适当配对结构，可比字段用带表头的表格，代码和命令用标注语言的代码块，因果与条件推理保留为段落或明确子结构。
- 建立不跳级且名称可区分的标题树，用真实标题元素或平台等价语义，而不是加粗模拟。给表格提供标题或说明、行列标题关联；给代码复制控件准确名称，并让溢出、换行和焦点在窄屏可用。
- 为每个可搜索小节分配稳定且唯一的锚点。搜索摘要引用该节实际内容；深链进入后显示目标标题、必要前提和版本，并把键盘焦点或读屏阅读位置置于合理起点。
- 评审同时做结构视图、移动端和读屏任务：隐藏装饰样式后仍能看出层级与关系；隐藏段落的“锚点检查”只用于发现埋藏信息，不能要求锚点独立替代完整答案。