Skip to main content

Extension for Python-Markdown that makes lists truly sane. Custom indents for nested lists and fix for messy linebreaks.

Project description

Build Status

An extension for Python-Markdown that makes lists truly sane. Features custom indents for nested lists and fix for messy linebreaks and paragraphs between lists.


  • nested_indent option: Custom indent for nested lists. Defaults to 2. Doesn’t mess with code indents, which is still 4.
  • truly_sane option: Makes linebreaks and paragraphs in lists behave as usually expected by user. No longer adds weird p, no extra linebreaks, no longer fuses lists together when they shouldn’t be fused (see screenshots and examples below). Defaults to True.
  • Inherits sane lists behavior, which doesn’t allow the mixing of ordered and unordered lists.


Pypi: ‘’

pip3 install mdx_truly_sane_lists

Directly from git:

pip3 install git+git://



from markdown import markdown

# Default config is truly_sane: True, nested_indent: 2
markdown(text='some text', extensions=['mdx_truly_sane_lists'])

With explicit config:

from markdown import markdown

markdown(text='some text',
             'mdx_truly_sane_lists': {
                 'nested_indent': 2,
                 'truly_sane': True,

Screenshots and examples

You can preview the new behaviour live at (uses nested_indent: 2, truly_sane: True)

Some ugly screenshots because I’m lazy and cannot into gimp:

image1 image2

Project details

Download files

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

Files for mdx-truly-sane-lists, version 1.0
Filename, size File type Python version Upload date Hashes
Filename, size mdx_truly_sane_lists-1.0.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page