Resources: Sphinx and Docutils

The main resource for writing sphinx extensions:

https://www.sphinx-doc.org/en/master/extdev/index.html#dev-extensions

The API's are also documented:

https://www.sphinx-doc.org/en/master/extdev/index.html#apis-used-for-writing-extensions

Sphinx is based on the Docutils Project:

1. http://docutils.sourceforge.net/
2. http://docutils.sourceforge.net/docs/

Specific Links to Components

Transforms: http://docutils.sourceforge.net/docs/ref/transforms.html

Other Projects

ipynb as source files to Sphinx

The nbsphinx project looks like it allows for ipynb as sources to the sphinx compilation system. It may be a useful resource when figuring out best default behaviours from rst to ipynb conversions.