diff --git a/docs/reference/images.md b/docs/reference/images.md
index 259db8330..75b879dbe 100644
--- a/docs/reference/images.md
+++ b/docs/reference/images.md
@@ -122,7 +122,7 @@ but it's always possible to use the [Markdown in HTML] extension with literal
 `figure` and `figcaption` tags:
 
 ``` html title="Image with caption"
-<figure markdown>
+<figure markdown="span">
   ![Image title](https://dummyimage.com/600x400/){ width="300" }
   <figcaption>Image caption</figcaption>
 </figure>