Documentation Sample / Test file / Advanced doc features¶
mkdocs macros plugin¶
This plugin allows providing some variables in mkdocs.yml file and then reference those variables using jinja2 syntax in md files. Most of these variables are populated and created during the DocBuild step and inserted into the yml file.
This theme provides the skin for the site. This also provides capabilities thru plugins.
The Material theme supports markdown extensions. Check the yml file for what extensions are currently on. Below is more specific info.
This plugin in combo with the material theme provides great looking ways for doc developers to highlight parts of their message.
Please check out: https://squidfunk.github.io/mkdocs-material/extensions/admonition/ for the capabilities and syntax.
Sample note here.
Who doesn't love using emojis. Icon usage has shown to help communicate directions and cross language barriers.
Twitter, github, and emojione tags available.
Check out the mkdocs.yml file for other extensions and details can be found in the links above.