如何把 Markdown 转成更易访问的 Word 文档
把 Markdown 转成 Word 后，文件看起来整齐，并不代表它对所有读者都容易使用。真正影响可访问性的，是标题是否有层级、列表是否是真列表、表格是否有表头、图片是否有替代文本，以及读者能否用键盘或屏幕阅读器找到内容。
更稳妥的做法是：先在 Markdown 中保留语义结构，再转换成可编辑的 DOCX，最后在 Word 中做一次无障碍检查。本文给出一套可以重复使用的流程，并说明每一步为什么有用、哪里容易出错。
先判断：你要解决的是排版问题，还是结构问题？
排版问题通常是字体、间距、页边距或模板选择；结构问题则决定辅助技术如何理解文档。一个标题即使视觉上很醒目，如果它只是普通段落加粗，屏幕阅读器和 Word 导航窗格仍可能无法把它当作标题。
Microsoft 的 Word 无障碍指南建议使用内置标题样式、为图片提供替代文本、为数据表指定表头，并避免复杂或固定宽度的表格。W3C 的 WCAG 2.2 也把文本替代和清晰的标题标签列为重要的可访问性要求，但 WCAG 是网页内容标准，不能单独当作某个 DOCX 文件的合规证明。
查看 Microsoft 的 Word 无障碍建议，再把其中能映射到源文档和导出文件的项目加入你的检查清单。
第一步：在 Markdown 源文件中建立可导航的结构
转换器只能根据源内容推断结构。源文件越明确，导出的 Word 越容易继续编辑和检查。
标题层级不要跳跃
把文档标题作为 H1，章节使用 H2，章节下的子主题使用 H3。不要为了让文字变大而直接跳到 H4，也不要把整段正文做成标题。W3C 的标题结构教程建议避免跳过标题等级，因为读者可能通过标题列表快速定位内容。
# 文档标题
## 交付范围
### 不包含的内容
## 检查步骤让列表、链接和图片表达真实含义
- 需要顺序时使用有序列表，需要并列项目时使用无序列表，不要用连字符和空格手工模拟层级。
- 链接文字直接说明目的，例如“下载项目验收清单”，不要只写“点击这里”。
- 有信息的图片写出内容和作用；纯装饰图才适合留空 ALT 或在 Word 中标记为装饰性。
- 不要只用颜色表示“通过”和“失败”，同时写出文字或使用明确符号。
例如，下面的图片语法已经包含了比“image.png”更有用的替代文本：
第二步：转换时优先保留语义，而不是追求预览完全一样
打开 DocuCraftBox Markdown 转 Word 工作区，粘贴 Markdown 或上传文件，选择 DOCX 输出，然后先检查预览，再下载结果。这个步骤的目标不是让 Word 页面和 Markdown 预览逐像素相同，而是让标题、列表、表格、链接和图片继续作为可编辑内容存在。
如果文档包含本地图片，保持相对路径并把图片和 Markdown 一起打包。转换完成后不要只看网页预览；请在目标 Word 编辑器中打开 DOCX，确认图片、链接和导航结构仍然存在。支持的 Markdown to Word 功能页面列出了标题、列表、表格、图片、题注和其他元素的处理范围。
第三步：在 Word 中完成无障碍验收
1. 检查标题是否真的进入导航结构
打开 Word 的导航窗格，查看标题是否按 H1、H2、H3 的关系排列。如果一个看起来像标题的段落没有出现在导航中，说明它可能只是视觉格式，而不是标题样式。修复时应给段落应用内置 Heading 样式，而不是继续调整字号。
2. 检查表格是否简单、有表头
数据表应有清晰的第一行表头，避免用合并单元格、嵌套表格或空白单元格制造复杂布局。固定宽度表格在放大或小屏阅读时更容易造成横向滚动。若信息不是表格数据，改成带标题的段落或列表通常更容易阅读。
3. 检查图片 ALT 是否说明“内容和用途”
图片已经显示出来，不代表替代文本已经保留。右键图片打开 ALT 文本，确认它描述了读者需要知道的内容，而不是文件名或“图片”。装饰性图片可以标记为装饰性，避免屏幕阅读器重复朗读无意义内容。
4. 检查链接文字、颜色和阅读顺序
逐个扫描链接文字，确认脱离上下文后仍能判断目标。需要表达状态时，同时使用文字、图标或结构，不要让颜色承担唯一含义。最后用键盘从标题开始移动焦点，观察阅读顺序是否符合文档逻辑。
完成手工检查后，打开 审阅 → 检查辅助功能。检查器能帮助你发现缺少 ALT、缺少表头和部分结构问题，但它不能替你判断每个图表的含义是否完整；最终仍要结合真实读者和使用场景复核。
常见失败：为什么“看起来正确”仍然不够？
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| 标题在页面上很醒目，但导航窗格没有它 | 只改了字号或加粗，没有应用标题样式 | 重新应用连续的内置 Heading 样式 |
| 表格能看，但检查器提示结构问题 | 第一行没有定义为表头，或表格用于排版 | 保留简单数据表并启用 Header Row |
| 图片正常显示，但读者不知道它表达什么 | ALT 丢失、过短或只是文件名 | 补充内容和用途；装饰图标记为装饰性 |
| 导出 PDF 后层级或阅读顺序异常 | 只检查了视觉结果，没有检查导出选项和标签 | 把 PDF 当作独立交付物重新检查，不要默认它继承全部语义 |
一份可以重复使用的交付清单
- 源 Markdown 只有一个文档 H1，后续标题按层级递进。
- 列表是真列表，链接文字描述目标，图片 ALT 描述内容和用途。
- 表格只承载数据，有明确表头，不用合并单元格做页面布局。
- DOCX 在目标编辑器中打开后，导航窗格、图片、链接和表格都能继续使用。
- 通过 Word 的检查辅助功能，并针对真实读者手工走一遍键盘和阅读顺序。
FAQ
Markdown 本身就是无障碍格式吗？
不是。Markdown 能清楚表达标题、列表、链接和图片替代文本，但最终可访问性还取决于转换器如何生成 DOCX，以及你是否检查了导出文件。
所有图片都必须写很长的 ALT 吗？
不需要。ALT 应该短而准确，说明读者需要理解的内容和用途。装饰性图片不应添加会打断阅读的多余描述。
可访问的 Word 文档还能使用模板和颜色吗？
可以。无障碍不是取消设计，而是让视觉样式建立在真实结构之上，并确保颜色不是唯一的信息渠道。先使用内置样式，再调整外观，通常比事后修复更省时间。
Word 的检查辅助功能通过后，文件就一定合规吗？
不能这样理解。它是一个实用的检查工具，不是针对所有读者、内容和法规场景的完整认证。对重要交付物，还应让实际使用者或无障碍专业人员参与复核。
结语
把 Markdown 转成更易访问的 Word 文档，关键不在于增加多少视觉装饰，而在于保留内容结构并完成一次真实验收。把标题、列表、表格、图片和链接当作可导航的信息，而不是页面上的形状，转换后的 DOCX 才更适合共享、审阅和长期维护。
如果你还需要检查源文件的表格、图片、代码和文档结构，可以先参考 Markdown 格式指南，再打开 Word 工作区生成可编辑 DOCX。
