skip to navigation
skip to content

MarkdownSubscript 2.0.0

Python-Markdown extension to allow for subscript text.

Latest Release:



Read Me

An extension to the Python Markdown project which adds the ability to subscript text. To do so, the character ~ becomes a Markdown tag for text meant to be subscripted, and is replaced with the HTML sub tag.

For example, given the text:

The molecular composition of water is H~2~O.

… using Markdown with this extension will output:

<p>The molecular composition of water is H<sub>2</sub>O.</p>

This project is provided under the Simplified (2 Clause) BSD license, provided in full in the LICENSE file.



  • Python 2.7, 3.3+
  • Markdown 2.5+ (Tested against latest patch version of Markdown 2.5 and 2.6)

To install the latest stable release (recommended):

pip install MarkdownSubscript

To install the development version:

pip install git+git://

Basic Usage


>>> from markdown import markdown
>>> text = "The molecular composition of water is H~2~O."
>>> markdown(text, ['subscript'])
'<p>The molecular composition of water is H<sub>2</sub>O.</p>'

Command Line

$ echo 'The molecular composition of water is H~2~O.' >
$ python -m markdown -o html5 -x 'subscript' -f text.html
File Type Py Version Uploaded on Size
MarkdownSubscript-2.0.0-py2.py3-none-any.whl (md5, pgp) Python Wheel py2.py3 2017-04-17 5KB
MarkdownSubscript-2.0.0.tar.gz (md5, pgp) Source 2017-04-17 4KB