To install django-markupmirror, use pip (or easy_install or simply python setup.py install from source) and add 'markupmirror' to the INSTALLED_APPS in your Django project.
If you want the FeinCMS content-type model MarkupMirrorContent, you’ll also need to add 'markupmirror.feincms' to your INSTALLED_APPS.
Also, you need to register the content-type model with FeinCMS’ Page module:
from feincms.module.page.models import Page
from markupmirror.feincms.models import MarkupMirrorContent
Page.create_content_type(MarkupMirrorContent)
In your settings.py specify at least MARKUPMIRROR_DEFAULT_MARKUP_TYPE which is 'plaintext' by default.
Add one or more markupmirror.fields.MarkupMirrorField s to your models and define markup_type or default_markup_type:
class ModelWithMarkup(models.Model):
content = MarkupMirrorField(
verbose_name="content", markup_type='markdown')
By default, django-markupmirror comes with markup converters for plain text (converts links and linebreaks) and HTML (does nothing). Converters for Markdown, reStructuredText and Textile are also available, but require 3rd-party libraries to be installed. However, you can register your own markup converters.