(sphinx/config-options)= # Sphinx configuration options You can control the behaviour of the MyST parser in Sphinx by modifying your `conf.py` file. To do so, use the keywords beginning `myst_`. `````{list-table} :header-rows: 1 * - Option - Default - Description * - `myst_commonmark_only` - `False` - If `True` convert text as strict CommonMark (all options below are then ignored). Note that strict CommonMark is unable to parse any directives, including the `toctree` directive, thus limiting MyST parser to single-page documentations. Use in conjunction with [sphinx-external-toc](https://github.com/executablebooks/sphinx-external-toc) Sphinx extension to counter this limitation. * - `myst_disable_syntax` - () - List of markdown syntax elements to disable, see the [markdown-it parser guide](markdown_it:using). * - `myst_enable_extensions` - `["dollarmath"]` - Enable Markdown extensions, [see here](../syntax/optional.md) for details. * - `myst_url_schemes` - `None` - [URI schemes](https://en.wikipedia.org/wiki/List_of_URI_schemes) that will be recognised as external URLs in `[](scheme:loc)` syntax, or set `None` to recognise all. Other links will be resolved as internal cross-references. * - `myst_linkify_fuzzy_links` - `True` - If `False`, only links that contain a scheme (such as `http`) will be recognised as external links. * - `myst_heading_anchors` - `None` - Enable auto-generated heading anchors, up to a maximum level, [see here](syntax/header-anchors) for details. * - `myst_heading_slug_func` - `None` - Use the specified function to auto-generate heading anchors, [see here](syntax/header-anchors) for details. * - `myst_substitutions` - `{}` - A mapping of keys to substitutions, used globally for all MyST documents when the "substitution" extension is enabled. * - `myst_html_meta` - `{}` - A mapping of keys to HTML metadata, used globally for all MyST documents. See [](syntax/html_meta). * - `myst_footnote_transition` - `True` - Place a transition before any footnotes. * - `myst_words_per_minute` - `200` - Reading speed used to calculate `` {sub-ref}`wordcount-minutes` `` ````` List of extensions: - "amsmath": enable direct parsing of [amsmath](https://ctan.org/pkg/amsmath) LaTeX equations - "colon_fence": Enable code fences using `:::` delimiters, [see here](syntax/colon_fence) for details - "deflist": Enable definition lists, [see here](syntax/definition-lists) for details - "dollarmath": Enable parsing of dollar `$` and `$$` encapsulated math - "html_admonition": Convert `