1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
(sphinx/config-options)=
# Configuration
MyST parsing can be configured at both the global and individual document level,
with the most specific configuration taking precedence.
## Global configuration
Overriding the default configuration at the global level is achieved by specifying variables in the Sphinx `conf.py` file.
All `myst_parser` global configuration variables are prefixed with `myst_`, e.g.
```python
myst_enable_extensions = ["deflist"]
```
:::{seealso}
Configuration in Docutils, in the [](docutils.md) section.
:::
```{myst-config}
:sphinx:
:scope: global
```
### Extensions
Configuration specific to syntax extensions:
```{myst-config}
:sphinx:
:extensions:
:scope: global
```
## Local configuration
```{versionadded} 0.18
```
The following configuration variables are available at the document level.
These can be set in the document [front matter](syntax/frontmatter), under the `myst` key, e.g.
```yaml
---
myst:
enable_extensions: ["deflist"]
---
```
```{myst-config}
:sphinx:
:scope: local
```
### Extensions
Configuration specific to syntax extensions:
```{myst-config}
:sphinx:
:extensions:
:scope: local
```
## List of syntax extensions
Full details in the [](syntax/extensions) section.
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
fieldlist
: Enable field lists, [see here](syntax/fieldlists) for details
html_admonition
: Convert `<div class="admonition">` elements to sphinx admonition nodes, see the [HTML admonition syntax](syntax/html-admonition) for details
html_image
: Convert HTML `<img>` elements to sphinx image nodes, [see here](syntax/images) for details
linkify
: Automatically identify "bare" web URLs and add hyperlinks
replacements
: Automatically convert some common typographic texts
smartquotes
: Automatically convert standard quotations to their opening/closing variants
strikethrough
: Enable strikethrough syntax, [see here](syntax/strikethrough) for details
substitution
: Substitute keys, [see here](syntax/substitutions) for details
tasklist
: Add check-boxes to the start of list items, [see here](syntax/tasklists) for details
|
