Package: cmsplugin-markdownx
To quote Richard Stallman, lo these many years ago, "What you see is what you get" == ""What you see is all there is!".This plugin does not replace the standard CMS text plugin, it is a new plugin class, Markdown.Home-page: https://github.com/bobhy/cmsplugin-markdownxAuthor: Bob HymanAuthor-email: bob.hyman@bobssoftwareworks.comLicense: MIT LicenseDescription: Shims the estimable [django-markdownx](https://github.com/adi-/django-markdownx) into the venerable [django-cms](https://github.com/divio/django-cms).Provides a `Markdown` plugin for Django-cms which stores content in markdown but displays as HTML.We consider it an advantage that the rendering is all done server-side,that ensures the editing preview looksjust like the final result in case we do preprocessing enhancements for the markdown dialect.* [Quick Start](#quick-start)* [Usage](#usage)* [Customization](#customization)* [Dependencies](#dependencies)* [License](#license)* [Changelog](#changelog)# Quick Start1. Install prerequisites, then `cmsmarkdown-markdownx` package.```bashpip install django-markdownxpip install cmsmarkdown-markdownx1. Add `cmsplugin_markdownx` to your `INSTALLED_APPS`.```python#settings.pyINSTALLED_APPS = (...'markdownx','cmsplugin_markdownx',)```1. Refer to [#customization] for additional settings you probably want to use.1. Add django-markdownx`s urls: (*not* in `il8n_patterns()`)```python#urls.pyurlpatterns = [[...]url(r'^markdownx/', include('markdownx.urls')),]```1. Collect included templates and statics to your `STATIC_ROOT` folder.```bashpython manage.py collectstatic```# Usage1. in CMS, edit a page with a placeholder.1. Add a `Markdown` plugin1. As you type, the preview window is updated (thank you @django-markdownx)From the 'frontend' view, you can update the plugin content.1. Be sure you're logged into CMS, with adequate privilees.1. Browse to a page containing Markdown1. Double-click on the section of the page containing the Markdown plugin.# Customization## SettingsPlace settings in your `settings.py` to override default values:```python#settings.py## for django-markdownx (see https://github.com/adi-/django-markdownx#customization)# MarkdownifyMARKDOWNX_MARKDOWNIFY_FUNCTION = 'markdownx.utils.markdownify'# Markdown extensionsMARKDOWNX_MARKDOWN_EXTENSIONS = ['markdown.extensions.extra','markdown.extensions.codehilite',       ## wants Pygments]# specify the code highlighting stylesheet used by `markdown.extensions.codehilite`CMSPLUGIN_MARKDOWNX_CODEHILITE_CSS = 'cmsplugin_markdownx/codehilite_colorful.css'```## Template TagsIf you want to design your own template to display rendered HTML from Markdown text, you need to do 2 things:1. Include the CMSPLUGIN_MARKDOWNX_CODEHILITE_CSS stylesheet in the CSS section of the page header.1. Run the markdown text from some instance of the Markdown plugin through the MARKDOWNX_MARKDOWNIFY_FUNCTION you configured for `django-markdownx'In order to do any or all of the above, you must load the template tags first.```html+django{% load cmsplugin_markdownx %}```### Custom tag `{% get_settings _settingsVariable_ default=None %}`This tag extracts the value of _settingsVariable_ from your site `settings.py`.  You can specify the default value to use if it is not defined.This tag is not dependent on markdown processing, it can be used in other apps and projects.### Filter `{{ ... |markdownify }}`Converts the markdown text provided by its left-hand argument into HTML using `django-markdownx`'s `MARKDOWNX_MARKDOWNIFY_FUNCTION`The HTML blob itself does not have a `<div`> wrapper, leaving you free to style one in the template.### Example```html_django{% load static sekizai_tags cmsplugin_markdownx %}{% get_setting "CMSPLUGIN_MARKDOWNX_CODEHILITE_CSS" as codehilite_css  %}{% if codehilite_css %}{% addtoblock "css" %}<link rel="stylesheet" href="{% static codehilite_css %}"/>{% endaddtoblock %}{% endif %}<div>{{ instance.markdown_text|markdownify }}</div>```# Dependencies* Markdown* Pillow* Django* jQuery# Licensecmsplugin-markdown is licensed under the MIT open source license. Read `LICENSE` file for details.# Changelog| version | date | notes || :---------: | :-------: | -------------------------- || 0.1 | Jan 29, 2017 | Initial release |Keywords: django,django-cms,plugin,markdown,editorPlatform: OS IndependentClassifier: Development Status :: 4 - BetaClassifier: Environment :: Web EnvironmentClassifier: Framework :: DjangoClassifier: Framework :: Django :: 1.10Classifier: Framework :: Django :: 1.9Classifier: Intended Audience :: DevelopersClassifier: License :: OSI Approved :: MIT LicenseClassifier: Operating System :: OS IndependentClassifier: Programming Language :: PythonClassifier: Programming Language :: Python :: 3.3Classifier: Programming Language :: Python :: 3.4Classifier: Programming Language :: Python :: 3.5Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic ContentClassifier: Topic :: Software DevelopmentClassifier: Topic :: Software Development :: Libraries :: Application FrameworksClassifier: Topic :: Text Processing :: Markup