Sorry for abusing your issue tracker, this is no bug report but rather an advertisement for my Sphinx extension nbsphinx that allows using Jupyter notebooks as Sphinx source files.

And the reason why I'm mentioning this here, is that I've just added a feature (spatialaudio/nbsphinx#234) that allows using jupytext in this process! This should allow using any files supported by jupytext as Sphinx source files.

See https://nbsphinx.readthedocs.io/en/latest/contents-manager.html for documentation.

Note that this feature is currently only available in the master branch, it will be available on PyPI with the next release. It would be great if some people could test it before the next release.

For now, you can install it directly from the Git repository (as described in CONTRIBUTING.rst) or you can use pip like this:

python3 -m pip install git+https://github.com/spatialaudio/nbsphinx.git@master

It would be great if you could try this out and give some feedback if it works and open some issues or pull requests if some things don't work!

Feel free to close this issue any time.