Django provides template filters that implement the following markup languages:
- textile – implements Textile – requires PyTextile
- markdown – implements Markdown – requires Python-markdown
- restructuredtext – implements reST (reStructured Text) – requires doc-utils
In each case, the filter expects formatted markup as a string and returns a string representing the marked-up text. For example, the textile filter converts text that is marked-up in Textile format to HTML.
To activate these filters, add 'django.contrib.markup' to your :setting:`INSTALLED_APPS` setting. Once you’ve done that, use {% load markup %} in a template, and you’ll have access to these filters. For more documentation, read the source code in django/contrib/markup/templatetags/markup.py.
When using the restructuredtext markup filter you can define a :setting:`RESTRUCTUREDTEXT_FILTER_SETTINGS` in your django settings to override the default writer settings. See the restructuredtext writer settings for details on what these settings are.
Jan 03, 2011