Skip to main content

Preprocessor for admonitions

Project description

Admonitions preprocessor for Foliant

Preprocessor which tries to make admonitions syntax available for most backends.

Admonitions are decorated fragments of text which indicate a warning, notice, tip, etc.

We use rST-style syntax for admonitions which is already supported by mkdocs backend with admonition extension turned on. This preprocessor makes this syntax work for pandoc and slate backends.


$ pip install foliantcontrib.admonitions


Just add admonitions into your preprocessors list. Right now the preprocessor doesn't have any options:

    - admonitions


Add an admonition to your Markdown file:

!!! warning "optional admonition title"
    Admonition text.

    May be several paragraphs.

Currently supported backends:

  • pandoc
  • mkdocs*
  • slate

* for admonitions to work in mkdocs, add admonition to the markdown_extensions section of your mkdocs.yml config:

                - admonition

Notes for slate

Slate has its own admonitions syntax of three types: notice (blue notes), warning (red warnings) and success (green notes). If another type is supplied, slate draws a blue note but without the "i" icon.

Admonitions preprocessor transforms some of the general admonition types into slate's for convenience (so you could use error type to display same kind of note in both slate and mkdocs). These translations are indicated in the table below:

original type translates to
error warning
danger warning
caution warning
info notice
note notice
tip notice
hint notice

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

foliantcontrib.admonitions-1.0.1.tar.gz (4.2 kB view hashes)

Uploaded Source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page