If you find bugs, errors, omissions or other things that need improvement, please create an issue or a pull request at Contributions are always welcome!

Instead of pip-installing the latest release from PyPI, you should get the newest development version (a.k.a. “master”) from Github:

git clone
cd nbsphinx
python3 -m pip install -e . --user

This way, your installation always stays up-to-date, even if you pull new changes from the Github repository. If you have only Python 3 installed, you might have to use the command python instead of python3. When installing nbsphinx this way, you can also quickly check other Git branches (in this example the branch is called “another-branch”):

git checkout another-branch

When you run Sphinx now, it automatically uses the version “another-branch” of nbsphinx. If you want to go back to the “master” branch, use:

git checkout master

To get the latest changes from Github, use:

git pull --ff-only

If you make changes to the documentation, you should create the HTML pages locally using Sphinx and check if they look OK:

python3 build_sphinx

To check the LaTeX output, use:

python3 build_sphinx -b latex

Again, you’ll probably have to use python instead of python3. The generated files will be available in the directories build/sphinx/html/ and build/sphinx/latex/, respectively.