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 预览器
  • 标题层级检查器
行动计划

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

使用真实资料前,请先在Markdown 链接完整性检查器中用合成数据试做《无障碍 Markdown 与 HTML 表格发布检查》的步骤。勾选状态只保留在当前标签页。

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

● 《无障碍 Markdown 与 HTML 表格发布检查》清单不会创建账户,也不会把您的内容发送到服务器;页面刷新后进度会被清除。

应用核验

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

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

01

Markdown 链接完整性检查器

准备
粘贴 Markdown 源文。
执行
运行本地链接检查。
验收检查
在发布环境中另行验证远程目标。
预期输出
编辑后的文本、变更摘要以及可量化的语言或结构指标. 无需网络请求即可查找 Markdown 中的断开引用、不安全协议和重复定义。
02

HTML 表格无障碍检查器

准备
添加包含表格的 HTML 片段。
执行
运行标记检查。
验收检查
使用键盘和屏幕阅读器测试真实页面。
预期输出
行列统计、规范化记录以及问题单元格位置. 查找 HTML 表格标记中缺失的标题、表头单元格、scope 和复杂关联。
03

Markdown 预览器

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

标题层级检查器

准备
加载安全示例或输入自己的数据。
执行
在设备端运行并检查错误、警告与指标。
验收检查
在目标环境和边界案例中验证输出。
预期输出
编辑后的文本、变更摘要以及可量化的语言或结构指标. 查找 Markdown 标题跳级、重复与空标题。
何时应停止?

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

检查记录

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