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 but separately from the main article, such as in the side-margin.
:::{aside} An Optional Title
This is an aside. It is not entirely relevant to the main article.
:::
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 an topic, with standalone ideas.
:::