| Anke (encarsia)
The default markup language of input files in Nikola is restructuredText. You can, of course, configure Nikola to also process Markdown formatted files but by default there are missing some features like admonitions or table of contents which can be enabled by extensions.
First things first: you have to edit the variables
PAGES of the conf.py and uncomment or add a line in order to make Nikola recognize and render Markdown files:
There are two types of Markdown extensions:
Officially supported extensions that are shipped with the python-markdown package.
Third party extensions which have to be installed separately on your system.
An extension is enabled by adding it to the
If you want to enable officially supported extensions you add the extensions' entry point as list item. If the extension is part of the extra folder you can use
extra as list item or the name of the extension, p.e. you enable definition lists with either
The list item for a third party extension is the exact dot notation (see the extension's documentation).
Some extensions offer configuration options. These are defined in the
MARKDOWN_EXTENSIONS_CONFIGS variable. The dictionary's structure is
Consult the extension's documentation for details. Useful extensions: