Add optional markdown for docstrings

rest_framework_docs/templates/rest_framework_docs/home.html

@@ -1,4 +1,5 @@
 {% extends "rest_framework_docs/docs.html" %}
+{% load drfdocs_filters %}
 
 {% block apps_menu %}
 {% regroup endpoints by name_parent as endpoints_grouped %}
@@ -56,7 +57,7 @@ <h4 class="panel-title title">
         <div id="{{ endpoint.path|slugify }}" class="panel-collapse collapse" role="tabpanel">
           <div class="panel-body">
             {% if endpoint.docstring %}
-            <p class="lead">{{ endpoint.docstring }}</p>
+            <p class="lead">{{ endpoint.docstring|markdown }}</p>
             {% endif %}
 
             {% if endpoint.errors %}

rest_framework_docs/templatetags/drfdocs_filters.py

@@ -0,0 +1,12 @@
+from django import template
+from django.template.defaultfilters import stringfilter
+from rest_framework.utils.formatting import markup_description
+
+
+register = template.Library()
+
+
+@register.filter(name='markdown')
+@stringfilter
+def markdown(value):
+    return markup_description(value)