13.9.10 Images in HTML export

HTML 导出后端可将 Org 图片链接转换为 HTML 行内图片与可点击图片链接。

当 Org 文件中的链接无描述文本时,HTML 导出后端默认会将其行内显示为图片。例如 ‘[[file:myimg.jpg]]’ 会直接显示图片,而 ‘[[file:myimg.jpg][the image]]’ 则显示为文本链接。详情见变量 org-html-inline-images

若 Org 链接的描述部分本身是另一个指向图片的 ‘file:’ 或 ‘https:’ 链接(具体规则由 org-html-inline-image-rules 定义),HTML 导出后端会行内显示该图片并链接到原图。该语法可实现低分辨率缩略图指向高分辨率原图,示例:

[[file:highres.jpg][file:thumb.jpg]]

如需修改行内图片属性,可在 Org 文件中使用 ‘#+ATTR_HTML’ 行。下例将图片右对齐,并添加 alttitle 属性以适配文本阅读器与现代网页无障碍标准。

#+CAPTION: A black cat stalking a spider
#+ATTR_HTML: :alt cat/spider image :title Action! :align right
[[./img/a.jpg]]

HTML 导出后端会原样保留 Org 文件中的 ‘http’ 链接。