then create the template and load the javascipt and css required to create the editor:

<html> <head> {{ form.media }} </head> <body>

{{ form }}

</body> </html>

---

## Showing/Hiding the Preview Box ##

You can control whether or not to show the dynamically rendered preview box below the pagedown widget in two ways:

- **Globally:** by using the `PAGEDOWN_SHOW_PREVIEW` option in your `settings.py` (this is mentioned further down the page). This will enable/disable the preview for *all* pagedown widgets throughout your application.

- **Per Widget:** by supplying a `show_preview` keyword argument when initialising your widget instance in your form. This gives you finer control over which of the fields can make use of the preview when rendering the pagedown widget. Note that this approach will take preference over the `PAGEDOWN_SHOW_PREVIEW` option.

If you want to customize the HTML used to render the pagedown widget altogether, you can. There are two ways:

- **Globally:** by default, the template used to render the pagedown widget is located at `pagedown/widgets/default.html`. - You can override this template by creating `pagedown/widgets/default.html` within your own template directory. This will take preference if you are using Django's default template loading system - You can use the `PAGEDOWN_DEFAULT_TEMPLATE` settings to point to a different template file- **Per Widget:** by supplying a `template` keyword argument when initialising your widget instance in your form. This should be the path to the template you wish to use to render this instance.

The following options can be added to your default `settings.py` file to control certain aspects of `django-pagedown`. Note that changing these will affect **all** instances of the pagedown widget throughout your app.:

- `PAGEDOWN_SHOW_PREVIEW` (boolean): whether or not to show the dynamic markdown preview below the markdown text area for the pagedown widgets. The default is `True`.- `PAGEDOWN_DEFAULT_TEMPLATE` (string): the template used to render the pagedown widget. The default template is located in `pagedown/widgets/default.html`. - `PAGEDOWN_WIDGET_CSS` (tuple): the path to the CSS file to be used by the pagedown widget. The default path is `pagedown/

---

## Rendering Markdown In Your Template ##

`contrib.markdown` was [depreciated in Django 1.5]https://code.djangoproject.com/ticket/18054 meaning you can no longer use the `markdown` filter in your template by default.

[@wkcd has a good example]https://github.com/timmyomahony/django-pagedown/issues/18#issuecomment-37535535 of how to overcome by installing `django-markdown-deux`:

{% extends 'base.html' %} {% load markdown_deux_tags %}

...

{{ entry.body|markdown }}

...

---

## TODO ##

- Add support for images uploading or hooks into the likes of `django-filer` etc.