title: Admonition prev_title: Smart Strong Extension prev_url: smart_strong.html next_title: CodeHilite Extension next_url: code_hilite.html Admonition ========== Summary ------- This extension adds [rST-style][rST] admonitions to Markdown documents. This extension is included in the standard Markdown library. [rST]: http://docutils.sourceforge.net/docs/ref/rst/directives.html#specific-admonitions Syntax ------ Admonitions are created using the following syntax: !!! [type] [optional explicit title within double quotes] Any number of other indented markdown elements. This is the second paragraph. `type` will be used as the CSS classname and as default title. It must be a single word. So, for instance: !!! note You should note that the title will be automatically capitalized. will render:

Note

You should note that the title will be automatically capitalized.

Optionally, you can use custom titles. For instance: !!! danger "Don't try this at home" ... will render:

Don't try this at home

...

If you don't want a title, use a blank string `""`: !!! important "" This is a admonition box without a title. results in:

This is a admonition box without a title.

rST suggests the following `types`, but you're free to use whatever you want: attention, caution, danger, error, hint, important, note, tip, warning. Styling ------- There is no CSS included as part of this extension. Look up the default [Sphinx][sphinx] theme if you need inspiration. [sphinx]: http://sphinx.pocoo.org/