Stencila Markdown supports images, audio, and video using familiar Markdown image syntax. Depending on the target resource, the same syntax can represent different media object types.
Media can appear inline within a paragraph:
An image , with alt text , with alt text and title 
Audio and video can also be referenced inline:
Some audio 
A video 
A media object on its own line is treated as block content:
As with standard Markdown images, you can provide alt text and an optional title:
A grapefruit sliceA grapefruit sliceAlt text is especially useful for accessibility and for outputs where the media itself may not be visible.
Use plain media syntax when you just want to embed an image, audio file, or video.
Use a Figure when the media should be treated as a first-class document element with:
For related authoring features, see:
For the formal Stencila Schema definitions behind these features, see:
