Asides, Margin Content, and Sidebars

Asides provide an easy way to represent content that is only indirectly related to the article’s main content. Where supported, MyST will attempt to display an {aside} as close as possible to—but separate from—the main article, such as in the side-margin.

:::{aside} Margin Content
Here’s some margin content! It was created by using the {myst:directive}`margin` directive in a Markdown, we can include images:

![](https://github.com/rowanc1/pics/blob/main/sunset.png)

or any other sort of content!
:::

You can also refer to this directive using {margin} or {sidebar}, which will have slightly different classes applied in the future.

Topics

A topic is like a block quote with a title, or a self-contained section. Use the “topic” directive to indicate a self-contained idea that is separate from the flow of the document. Semantically, this is an <aside>.

:::{topic} This is an optional topic title
This is a topic, with standalone ideas.
:::