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, part of Jupyter.