Metadata-Version: 2.4
Name: minchin.md-it.superscript
Version: 1.0.1
Summary: Superscript, for Markdown-IT-py
Author-email: William Minchin <w_minchin@hotmail.com>
Maintainer-email: William Minchin <w_minchin@hotmail.com>
License: MIT
Project-URL: Bug Tracker, https://github.com/MinchinWeb/minchin.md-it.superscript/issues
Project-URL: Repository, https://github.com/MinchinWeb/minchin.md-it.superscript
Project-URL: Changelog, https://github.com/MinchinWeb/minchin.md-it.superscript/blob/master/CHANGELOG.rst
Keywords: commonmark,markdown,plugin,superscript
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Plugins
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Topic :: Text Processing :: Markup :: Markdown
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/x-rst
Requires-Dist: markdown-it-py
Provides-Extra: dev
Requires-Dist: pip-tools; extra == "dev"
Requires-Dist: minchin.releaser>=0.9.5; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: isort; extra == "dev"
Requires-Dist: pytest; extra == "dev"

Superscript for Markdown-IT-Py
==============================

This is a plugin for the Python implementation of
`Markdown-IT <https://github.com/executablebooks/markdown-it-py>`_ (a CommonMark
parser) that provides superscript (``<sup>``) via carets (``^``).

Markup is based on the `Pandoc superscript extension
<https://pandoc.org/MANUAL.html#superscripts-and-subscripts>`_.

Place superscripted text within caret ``^`` characters. You must escape any
spaces in the superscripted text. Note that you cannot use newline or tab
characters, and that nested markup is not supported.

Example usage::

    >>> from markdown_it import MarkdownIt
    >>> from minchin.md_it.superscript import superscript_plugin
    >>> md = MarkdownIt().use(superscript_plugin)
    >>> md.render("1^st^")
    '<p>1<sup>st</sup></p>\\n'
    >>> md.render("this^text\\\\ has\\\\ spaces^")
    '<p>this<sup>text has spaces</sup></p>\\n'

Tests can be run using ``pytest``.


For whatever reason, subscript was added to the "official" *mdit-py-plugins*
collection, but superscript has been langishing as an open pull reqest for the
past six months. This is meant as an interim measure so I can make use of the
plugin locally, until such time as the upstream pull request lands. Maybe
you'll find it helpful too!
