Visibility of Figure Captions in Quarto

pandoc

quarto

diary

Author

Guest_1013

Published

2026-06-06

You may notice that in links page, there are no captions under each badge; yet in other pages (like this one), captions appear naturally.

The reason hides in the documentation of figures in quarto:

Note that the empty lines between the figures (and between the last figure and the caption) are required (it’s what indicates that these images belong to their own paragraphs rather than being multiple images within the same paragraph).

If the figures in the source code possess empty lines, they are considered as separate paragraphs and captions are rendered normally; otherwise they are not rendered.

---
title: "Visibility of Figure Captions in Quarto"
author: "Guest_1013"
date: 2026-06-06
categories: ["pandoc", "quarto", "diary"]
---

You may notice that in [links](/links.qmd) page, there are no captions under each badge; yet in other pages (like [this one](/blog/posts/20260606-DIN-fonts.qmd)), captions appear naturally.

The reason hides in the [documentation](https://quarto.org/docs/authoring/figures.html#subfigures) of figures in quarto:

> Note that the empty lines between the figures (and between the last figure and the caption) are required (it’s what indicates that these images belong to their own paragraphs rather than being multiple images within the same paragraph).

If the figures in the source code possess empty lines, they are considered as separate paragraphs and captions are rendered normally; otherwise they are not rendered.