aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README17
1 files changed, 17 insertions, 0 deletions
diff --git a/README b/README
index 801fda040..113472a6f 100644
--- a/README
+++ b/README
@@ -909,6 +909,23 @@ code block above will appear as follows:
</code>
</pre>
+Images with captions
+--------------------
+
+An image occurring by itself in a paragraph will be rendered as
+a figure with a caption. (In LaTeX, a figure environment will be
+used; in HTML, the image will be placed in a `div` with class
+`figure`, together with a caption in a `div` with class `caption`.)
+The image's alt text will be used as the caption.
+
+ ![This is the caption](/url/of/image.png)
+
+If you just want a regular inline image, just make sure it is not
+the only thing in the paragraph. One way to do this is to insert a
+nonbreaking space after the image:
+
+ ![This image won't be a figure](/url/of/image.png)\
+
Title blocks
------------