Skip to main content

ghoster is a admin theme which includes markdown features for Django users

Project description

ghoster is a admin theme which includes markdown features for Django users.


regular template:

markdown template:


  • python >= 2.7

  • django >= 1.9


  1. Download it from PyPi with pip install django-ghoster

  2. Add into the INSTALLED_APPS before django.contrib.admin:

  1. don’t forget to python collectstatic


In, assume the model is defined as below:

from django.db import models

class MyModel(models.Model):
    # the fields which are rendered into markdown
    char_field = models.CharField(max_length=1024)
    text_field = models.TextField()

    # other stuff
    foreign_field = ...
    file_field = ...
    url_field = ...

Then in, inherit GhosterAdmin and override markdown_field and title_field attributes with the field names.

from django.contrib import admin
from ghoster.admin import GhosterAdmin
from .models import MyModel

class MyModelAdmin(GhosterAdmin):
    markdown_field = "text_field"
    title_field = "char_field"

    # other stuff
    list_display = ...
    list_filter = ..., MyModelAdmin)

Then ghoster will render the model-form into 3 parts:

  • title_field: this field will be placed in top-bar.

  • markdown_field: markdown editor with side-by-side preview.

  • meta_fieldsets: the rest of fields will be placed in right-sidebar.


Every code, documentation and UX contribution is welcome. If you have any suggestions or bug reports please report them to the issue tracker

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

django_ghoster-0.1.2-py2.py3-none-any.whl (1.7 MB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page