docstring-to-markdown 0.1

On the fly conversion of Python docstrings to markdown

docstring-to-markdown

On the fly conversion of Python docstrings to markdown

• Python 3.6+
• currently can recognise reStructuredText and convert multiple of its features to Markdown
• in the future will be able to convert Google docstrings too

Installation

pip install docstring-to-markdown

Example

Convert reStructuredText:

>>> import docstring_to_markdown
>>> docstring_to_markdown.convert(':math:`\\sum`')
$\\sum$

When given the format cannot be recognised an exception will be raised:

>>> docstring_to_markdown.convert('\\sum')
UnknownFormatError()

Development

pip install -e .
pytest