A link immediately preceded by a !
will be treated as an
image. The link text will be used as the image’s alt text:

![movie reel]
[movie reel]: movie.gif
implicit_figures
An image with nonempty alt text, occurring by itself in a paragraph, will be rendered as a figure with a caption. The image’s alt text will be used as the caption.

How this is rendered depends on the output format. Some output formats (e.g. RTF) do not yet support figures. In those formats, you’ll just get an image in a paragraph by itself, with no caption.
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:
\
Note that in reveal.js slide shows, an image in a paragraph by itself
that has the r-stretch
class will fill the screen, and the
caption and figure tags will be omitted.
link_attributes
Attributes can be set on links and images:
An inline {#id .class width=30 height=20px}
and a reference ![image][ref] with attributes.
[ref]: foo.jpg "optional title" {#id .class key=val key2="val 2"}
(This syntax is compatible with PHP Markdown
Extra when only #id
and .class
are
used.)
For HTML and EPUB, all known HTML5 attributes except
width
and height
(but including
srcset
and sizes
) are passed through as is.
Unknown attributes are passed through as custom attributes, with
data-
prepended. The other writers ignore attributes that
are not specifically supported by their output format.
The width
and height
attributes on images
are treated specially. When used without a unit, the unit is assumed to
be pixels. However, any of the following unit identifiers can be used:
px
, cm
, mm
, in
,
inch
and %
. There must not be any spaces
between the number and the unit. For example:
{ width=50% }
--dpi
option (by
default, 96 dpi is assumed, unless the image itself contains dpi
information).%
unit is generally relative to some available
space. For example the above example will render to the following.
<img href="file.jpg" style="width: 50%;" />
\includegraphics[width=0.5\textwidth,height=\textheight]{file.jpg}
(If you’re using a custom template, you need to configure
graphicx
as in the default template.)\externalfigure[file.jpg][width=0.5\textwidth]
\caption
), or both
(HTML).width
or height
attributes are
specified, the fallback is to look at the image resolution and the dpi
metadata embedded in the image file.