行动计划

把指南转化为安全试用流程

在使用真实数据前,请先用合成示例完成这些步骤。勾选状态只保留在当前标签页。

0%0/4 已完成
  1. 打开工具
  2. 打开工具
  3. 打开工具
  4. 打开工具

此清单不创建账户、不向服务器发送数据,并会在刷新页面后清除。

01

链接文本应说明目标

‘点击这里’或裸 URL 无法为通过链接列表导航的读者提供上下文。文本应简要说明目标,并在有用时标明文件类型或外部网站。

不要让相同可见文本指向不同目标;意外的新标签页、下载或语言变化应明确告知。

  • 脱离句子单独阅读链接。
  • 需要时标明目标类型。
  • 保持键盘焦点可见。
02

在本地验证引用与 URL 语法

未定义引用标识和重复定义可能因 Markdown 引擎不同而变成纯文本或错误目标。用户内容中的 javascript:、data: 等可执行协议应被拒绝。

本地工具不发起网络请求,因此无法验证 404、重定向、TLS 或目标所有权;发布 CI 应在允许列表和限速下补充检查。

03

只为真正的表格数据使用表格

为对齐非二维关系内容而使用表格会损害移动端和屏幕阅读器体验。简单标签-值内容更适合定义列表、卡片或正文。

数据表需要简洁 caption、语义化 th,并为简单行列标题明确提供 scope。

04

设计复杂关联和移动行为

多级表头、合并单元格和小计可能需要 id/headers 关联或更简单的替代视图。视觉加粗不能替代语义表头。

窄屏横向滚动区域应可聚焦且有标签;不要用 CSS 隐藏导致信息丢失的列,可提供摘要和完整表格入口。

05

用真实使用测试完成自动化检查

静态检查可发现 caption、th 和 scope 缺失,但阅读顺序、链接可理解性和缩放溢出需要真实浏览器。测试键盘、屏幕阅读器、200% 缩放和深浅主题。

问题记录应包含复现步骤、受影响用户、预期行为和验收标准,而不仅是截图;单一工具输出不能证明符合 WCAG。

  • 至少执行一次辅助技术测试。
  • 用键盘尝试移动端滚动。
  • 使用同一 fixture 复测。
06

本指南配套工具

下列工具为同一决策提供不同证据。请结合真实环境、合同或权威来源分别核验每项输出;先用合成数据复现流程,再记录人工验收标准与停止条件。

  • Markdown 链接完整性检查器
  • HTML 表格无障碍检查器
  • Markdown 预览器
  • 标题层级检查器
应用核验

把指南转化为可重复的检查流程

请使用这套包含 4 个工具的检查计划来落实《无障碍 Markdown 与 HTML 表格发布检查》。目标:详细指南:把文档链接完整性和表格无障碍自动检查连接到真实键盘与屏幕阅读器测试。 请先用安全示例代替真实数据,并记录每一步的预期结果与验收决定。

01

Markdown 链接完整性检查器

准备
Markdown 链接完整性检查器的输入应为在保留用途和目标语言的前提下需要编辑或比较的纯文本。本次处理目标是:无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义。处理敏感真实数据前,请先用合成示例确认格式。
执行
运行设备端处理。Markdown 链接完整性检查器为实现“无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义”采用以下可解释方法:在保留 Unicode、行和词边界的同时应用确定性文本规则。
验收检查
验收检查:接受Markdown 链接完整性检查器的结果前,请完成对可能改变语义的句子、专有名词、数字、标点和多语言字符进行前后比较;核验证据应与“无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义”这一目标一致。Markdown 链接完整性检查器的使用边界:语言、语义和上下文仍需人工最终审核。
预期输出
Markdown 链接完整性检查器完成后会提供编辑后的文本、变更摘要以及可量化的语言或结构指标,并围绕“无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义”组织结果。. 无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义。
02

HTML 表格无障碍检查器

准备
HTML 表格无障碍检查器的输入应为表头和行结构一致的 CSV、TSV、表格或分隔记录。本次处理目标是:查找 HTML 表格标记中缺失的标题、表头单元格、scope 和复杂关联。处理敏感真实数据前,请先用合成示例确认格式。
执行
运行设备端处理。HTML 表格无障碍检查器为实现“查找 HTML 表格标记中缺失的标题、表头单元格、scope 和复杂关联”采用以下可解释方法:分隔符、引号、行边界和列边界会分别检查。
验收检查
验收检查:接受HTML 表格无障碍检查器的结果前,请完成核对表头数量、行宽、引号转义,并在目标表格中打开代表性记录;核验证据应与“查找 HTML 表格标记中缺失的标题、表头单元格、scope 和复杂关联”这一目标一致。HTML 表格无障碍检查器的使用边界:语言、语义和上下文仍需人工最终审核。
预期输出
HTML 表格无障碍检查器完成后会提供行列统计、规范化记录以及问题单元格位置,并围绕“查找 HTML 表格标记中缺失的标题、表头单元格、scope 和复杂关联”组织结果。. 查找 HTML 表格标记中缺失的标题、表头单元格、scope 和复杂关联。
03

Markdown 预览器

准备
Markdown 预览器的输入应为在保留用途和目标语言的前提下需要编辑或比较的纯文本。本次处理目标是:编写 Markdown,并查看安全 HTML 预览与输出代码。处理敏感真实数据前,请先用合成示例确认格式。
执行
运行设备端处理。Markdown 预览器为实现“编写 Markdown,并查看安全 HTML 预览与输出代码”采用以下可解释方法:在保留 Unicode、行和词边界的同时应用确定性文本规则。
验收检查
验收检查:接受Markdown 预览器的结果前,请完成对可能改变语义的句子、专有名词、数字、标点和多语言字符进行前后比较;核验证据应与“编写 Markdown,并查看安全 HTML 预览与输出代码”这一目标一致。Markdown 预览器的使用边界:语言、语义和上下文仍需人工最终审核。
预期输出
Markdown 预览器完成后会提供编辑后的文本、变更摘要以及可量化的语言或结构指标,并围绕“编写 Markdown,并查看安全 HTML 预览与输出代码”组织结果。. 编写 Markdown,并查看安全 HTML 预览与输出代码。
04

标题层级检查器

准备
标题层级检查器的输入应为在保留用途和目标语言的前提下需要编辑或比较的纯文本。本次处理目标是:查找 Markdown 标题跳级、重复与空标题。处理敏感真实数据前,请先用合成示例确认格式。
执行
运行设备端处理。标题层级检查器为实现“查找 Markdown 标题跳级、重复与空标题”采用以下可解释方法:在保留 Unicode、行和词边界的同时应用确定性文本规则。
验收检查
验收检查:接受标题层级检查器的结果前,请完成对可能改变语义的句子、专有名词、数字、标点和多语言字符进行前后比较;核验证据应与“查找 Markdown 标题跳级、重复与空标题”这一目标一致。标题层级检查器的使用边界:语言、语义和上下文仍需人工最终审核。
预期输出
标题层级检查器完成后会提供编辑后的文本、变更摘要以及可量化的语言或结构指标,并围绕“查找 Markdown 标题跳级、重复与空标题”组织结果。. 查找 Markdown 标题跳级、重复与空标题。
何时应停止?

Markdown 链接完整性检查器适用以下边界:Markdown 链接完整性检查器的使用边界:语言、语义和上下文仍需人工最终审核。 如果未满足该条件,请勿把输出传递到工作流的下一步。

检查记录

落实《无障碍 Markdown 与 HTML 表格发布检查》时,请记录工具名称、所选设置、浏览器版本,以及“使用Markdown 链接完整性检查器完成:无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义”的接受或拒绝理由,而不是敏感内容。这样既能重复检查,也不会复制真实数据。