Markdown Syntax

Thanks to the installed myst-parser, you can author pages on this site using Markdown, which is a lot easier to grep than ReStructuredText.

myst-specific Markdown syntax

See the following links from myst-parser for specific Markdown syntax:

• Typography

• Admonitions

  • Note: Admonitions will appear differently due to the Shibuya theme we’re using. See the Shibuya link below for an idea of how admonitions will actually render.

• Images and figures

• Tables

Shibuya theme

This site uses the Shibuya theme for Sphinx.

You can check the Shibuya Writing Guide for an idea of how different components will render, even if you write them in Markdown.

Icons

We have a plugin installed that allows for the use of all icons available from Iconify. See the Icons page for specific syntax and to browse available icons.