@@ -909,6 +909,23 @@ code block above will appear as follows:
909909 </code>
910910 </pre>
911911
912+Images with captions
913+--------------------
914+
915+An image occurring by itself in a paragraph will be rendered as
916+a figure with a caption. (In LaTeX, a figure environment will be
917+used; in HTML, the image will be placed in a `div` with class
918+`figure`, together with a caption in a `div` with class `caption`.)
919+The image's alt text will be used as the caption.
920+
921+ 
922+
923+If you just want a regular inline image, just make sure it is not
924+the only thing in the paragraph. One way to do this is to insert a
925+nonbreaking space after the image:
926+
927+ \
928+
912929Title blocks
913930------------
914931