指南
带标签的 PDF,一次讲清
学校或机构要求提交「带标签 / 无障碍」的 PDF。这一页只讲三件事:他们到底查什么、为什么会不通过、在 Markdown 里怎么改最省事。
MarkdownGo 从 Markdown 出发:免费检查读的是粘贴的正文、.md 文件或已导出的 PDF,新 PDF 由导出生成。它不修复现成的 PDF——扫描件或别处生成的文件需要 OCR 加人工打标签。
带标签的 PDF 到底是什么
PDF 本质是一堆画出来的字形。打标签是在上面加一棵结构树:这段是标题、那段是正文、这张图是带替代文本的插图。读屏软件跟着结构树走,而不是跟着画面走。没有标签时,它只能猜,通常把整篇读成一整段。
PDF/UA 才是「带标签、可无障碍阅读」的标准;PDF/A 管的是长期归档(字体嵌入、不依赖外部资源)。两者不是一回事,有其中一个不等于有另一个。
检查项到底有哪些
- 文档标题:读屏软件播报的名字,不是文件名。
- 文档语言:读屏要知道该用中文还是英文发音。
- 标题层级不跳级:一级、二级、三级依序,不能从一级直接跳到三级。
- 有意义的图片必须有替代文本;纯装饰图给空 alt。
- 阅读顺序与原文一致;长文档还要有书签。
在 Markdown 里怎么改
- 标题:在 Front Matter 里写 `title:`,或者文件顶部只保留一个一级标题。
- 语言:在 Front Matter 里写 `lang: zh-CN`,或让导出器按正文自动检测。你在界面上选择的语言不会决定它。
- 标题层级:一个 `#`,然后 `##`、`###`。跳级是最常见的失败原因。
- 替代文本:图表写 ``;分隔线这类装饰写 ``。
- 阅读顺序:按你希望被阅读的顺序写。左右并排的 HTML 块是最常见的元凶。
提交前先自己验一遍
先跑免费检查:它读你的 Markdown 或已导出的 PDF,报出上面这些源文档层面的问题——标题、标题跳级与替代文本——并标出哪些导出时会自动修复。文档语言来自 Front Matter 的 `lang:`,或自动检测——不是界面语言。阅读顺序与书签属于导出后的 PDF,请在导出后用阅读器确认。
三句话回答
PDF/A 是不是就等于无障碍?
不等于。PDF/A 管归档(字体嵌入、无外部依赖),无障碍靠标签,那是 PDF/UA。
检查 PDF 一定要装 Acrobat 吗?
不用。免费检查在导出前读你的 Markdown,也可以直接上传已导出的 PDF 检查;导出后任何能看结构树的阅读器(或免费检查器)都能复核。
学校会认这份导出吗?
先问清他们要求哪个标准(PDF/UA、带标签的 WCAG,还是他们自己的清单)。如果是 PDF/UA,导出时要打开 PDF/UA 开关;但导出仍要通过上面的检查,并满足学校自己的审核要求。