Figures for Images
This deck demonstrates how Pandoc handles images as figures and captions
September 22, 2025
Samantha Monty
Chair for Human-Computer Interaction, University of Würzburg

Figures for Images

Pandoc 2.0

As of Pandoc 2.0:

An image with nonempty alt text, occurring by itself in a paragraph, will be rendered as a figure with a caption. The image’s alt text will be used as the caption.

Image with figure

Strangely, this does not work.

include/06-metal.png
This is the alt text of the image

Strangely, this does not work.

Source code

![This is the alt text of the image](include/06-metal.png)

Naked Images

Image without caption

include/06-metal.png

Source code

![](include/06-metal.png)

Naked Image with Caption

Image with caption

include/06-metal.png
Alt text as caption

Source code

![Alt text as caption](include/06-metal.png)

Caption as Extra Line

Image with caption

include/06-metal.png
Caption on an extra line.

Source code

![](include/06-metal.png)

Caption: Caption on an extra line.

Naked Image Pair

Two images with caption

hallo include/06-metal.pngCaption 1 holla include/06-metal.pngCaption 2

Just a line of text

Source code

hallo ![Caption 1](include/06-metal.png){width="45%"} holla ![Caption 2](include/06-metal.png){width="45%"}

Just a line of text