Skip to article content

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.


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.
MyST MarkdownMyST Markdown
Community-driven tools for the future of technical communication and publication