Markdown syntaxΒΆ
Markdown files can also be used to generate the a page. All basic markdown syntax is recognised.
Additional features like admonitions are used as a code block.
Admonition code
```{tip}
:collapsible: open
Here your text.
```
Basically all directives used in rst can be used in this style in markdown. A feature is also to use directly html code without any additional statements. This should be avoided, as readability and user-friendliness are greatly reduced after this use.
To use rst commands in the markdown files, use eval-rst as the command like the following example:
Including rst code
```{eval-rst}
<your rst command>
```
See also
For more informations, have a look in official documentation.