From ac30daaa9c809bcbf31cb407598027de9691b083 Mon Sep 17 00:00:00 2001
From: pana-exfo <138116383+pana-exfo@users.noreply.github.com>
Date: Mon, 21 Aug 2023 19:16:16 +0300
Subject: [PATCH] Updated image guide (#5823)

Added another option how markdown_captions extension can be used to show image alt text as caption.
---
 docs/reference/images.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/reference/images.md b/docs/reference/images.md
index c13cf86ee..824e13502 100644
--- a/docs/reference/images.md
+++ b/docs/reference/images.md
@@ -136,6 +136,21 @@ but it's always possible to use the [Markdown in HTML] extension with literal
   </figure>
 </div>
 
+
+Another option is to use [Markdown captions](https://github.com/Evidlo/markdown_captions) extension 
+which converts images with alt text to \<figure\> with \<figcaption\>.
+
+``` html title="Image with caption"
+  ![Image caption](https://dummyimage.com/600x400/){ width="300" }
+```
+
+<div class="result">
+  <figure>
+    <img src="https://dummyimage.com/600x400/f5f5f5/aaaaaa?text=–%20Image%20–" width="300" />
+    <figcaption>Image caption</figcaption>
+  </figure>
+</div>
+
 ### Image lazy-loading
 
 Modern browsers provide [native support for lazy-loading images][lazy-loading]