Pandoc HTML to DOCX：如何正确指定图像的替代文本

Question

当使用 Pandoc 将 HTML 文件转换为 DOCX 文件时，我预计图像的 alt 属性将被转换为 DOCX 文件中的图像标题（具有“图像标题”样式）。但这似乎并非如此。

它似乎只适用于 Markdown 的语法：使用 ![alt text](xxx.jpg)，alt 文本在 Word 中被转换为“图片标题”样式的元素。

但我无法让它与 HTML 一起使用，即使是 <figure> 的 <figcaption> 也只能转换为标准段落，而不是 Word 中的“图像标题”样式。

在 HTML 中应该怎么做？

Answer 1

以下 HTML 将是 converted to a figure:

<p><img src="xxx.jpg" alt="alt text" title="fig:"></p>

有两个技巧：

1. img 必须单独出现在一个段落中
2. title 属性必须以fig: 开头

Answer 2

在较新版本的 Pandoc（例如 2.9.x）中，alt 属性被用作替代文本，正如预期的那样。

所以![alt text](xxx.jpg) 现在可以完美运行。谢谢 Pandoc 团队！