MyST Markdown is a flavor of markdown that gives you full access to all of the functionality provided by Sphinx (such as roles and directives). In MyST-NB, this is provided by the MyST Parser, another Sphinx extension that MyST-NB depends on.
You can write your MyST markdown in either regular markdown files (.md
) or in
the markdown cells of Jupyter Notebooks (.ipynb
).
If you are using MyST-NB in your documentation, do not activate `myst-parser`. It will
be automatically activated by `myst-nb`.
For more information about what you can write with MyST Markdown, see the MyST Parser syntax guide.
You can change which files are parsed by MyST-NB using
the source_suffix
option in your conf.py
, e.g.:
extensions = ["myst_nb"]
source_suffix = {
'.rst': 'restructuredtext',
'.ipynb': 'myst-nb',
'.myst': 'myst-nb',
}