Images and figures
MyST Markdown can be used to include images and figures in your documents as well as referencing those images easily throughout your website, article or paper.
The simplest way to create an image is to use the standard Markdown syntax:
You can explore a in the discussion of CommonMark features of MyST.
Using standard markdow to create an image will render across all output formats (HTML, TeX, Word, PDF, etc). However, this markdown syntax is limited in the configuration that can be applied beyond
alt text and an optional
title. For example, the image width, alignment or a figure caption cannot be set with this syntax.
There are two directives that can be used to add additional information about the layout and metadata associated with an image.
imagedirective allows you to customize width, alignment, and other classes to add to the image
figuredirective can contain a figure caption and allows you to cross-reference this in other parts of your document.