These markups are available by default:
There are several ways to enable Python-Markdown extensions.
List extensions in a file named
markdown-extensions.txtin the configuration directory. The extensions will be automatically applied to all documents.
markdown-extensions.txtis placed into working directory, all documents in that directory will get extensions that are listed in that file.
If first line of a document contains “
Required extensions: ext1 ext2 …”, that list will be applied to a document.
Finally, one can programmatically pass list of extension names to
The YAML file should be a list of extensions, possibly with configuration options, for example:
- smarty: substitutions: left-single-quote: "‚" right-single-quote: "‘" smart_dashes: False - toc: permalink: True separator: "_" toc_depth: 3 - sane_lists
Or using a JSON-like syntax:
YAML support works only when the PyYAML module is installed.
The txt file is a simple list of extensions, separated by newlines. Lines
# are treated as comments and ignored. It is possible to
specify string options in brackets, for example:
The same syntax to specify options works in the
line. You can put it into a comment to make it invisible in the output:
<!-- Required extensions: toc(title=Contents) sane_lists -->
To enable single-dollar-sign delimiter, one should add
mdx_math(enable_dollar_delimiter=1)to the extensions list.
The Python-Markdown Extra set of extensions is enabled by default.
To disable it, one can enable virtual
(which also completely disables LaTeX formulas support).
The default file extension associated with Markdown markup is
though many other extensions (including
supported as well.
The file extension associated with reStructuredText markup is