Skip to content

Documentation

mkdocs-material

This project uses mkdocs-material to manage and dynamically generate documentation as a set of static websites.

To generate and view the compiled documentation locally, run the following within the activated poetry virtual environment:

mkdocs build
mkdocs serve

Admonitions

The admonitions extension is used to provide callouts. The list of available admonitions is available to customize callouts.

Examples:

!!! note
    This is a note.

Note

This is a note.

!!! warning
    This is a warning.

Warning

This is a warning.

Buttons and Icons

The icon search page has a quick lookup of available icons that mkdocs-material supports.

[Send :fontawesome-solid-paper-plane:](#){ .md-button }

Send

Example Sites Using Mkdocs-Material

  • up42 is a nice example of customizing mkdocs-material defaults.