/pheasant

Documentation tool for Markdown conversion by Jupyter client

Primary LanguagePythonMIT LicenseMIT

Pheasant

PyPI Version Python Version Build Status Coverage Status

Pheasant is a Markdown converter which is designed to be used as a plugin for static site generators, especially MkDocs. The one of the main features of Pheasant is auto Markdown generation of outputs after execution of any Python or other language codes written in a fenced code block of Markdown source. This process is executed by the Jupyter client functionality.

Setup

Install the plugin using pip:

pip install pheasant

Next, add the following lines to your mkdocs.yml:

plugins:
  - search
  - pheasant