This notebook is part of the nbsphinx documentation: https://nbsphinx.readthedocs.io/.

External Links

nbconvert

The official conversion tool of the Jupyter project. It can be used to convert notebooks to HTML, LaTeX and many other formats.

Its --execute flag can be used to automatically execute notebooks before conversion.

https://nbconvert.readthedocs.io/

https://github.com/jupyter/nbconvert

RunNotebook (notebook_sphinxext.py)

Notebooks can be included in *.rst files with a custom notebook directive. Uses nbconvert to execute notebooks and to convert the result to HTML.

No LaTeX support.

https://github.com/ngoldbaum/RunNotebook

There are some forks:

nbsite

Build a tested, sphinx-based website from notebooks.

https://nbsite.holoviz.org/

ipypublish

A workflow for creating and editing publication ready scientific reports and presentations, from one or more Jupyter Notebooks, without leaving the browser!

https://ipypublish.readthedocs.io/

https://github.com/chrisjsewell/ipypublish

jupyterbook

Jupyter Book is an open source project for building beautiful, publication-quality books and documents from computational material.

https://jupyterbook.org/

https://github.com/executablebooks/jupyter-book

Previous tagline: "Create an online book with Jupyter Notebooks and Jekyll": https://legacy.jupyterbook.org/

MyST-NB

A collection of tools for working with Jupyter Notebooks in Sphinx.

The primary tool this package provides is a Sphinx parser for ipynb files. This allows you to directly convert Jupyter Notebooks into Sphinx documents. It relies heavily on the MyST parser.

https://myst-nb.readthedocs.io/

https://github.com/executablebooks/MyST-NB

notebook-to-pdf

This Jupyter notebook extension allows you to save your notebook as a PDF.

Three new features compared to the official "save as PDF" extension:

  1. produce a PDF with the smallest number of page breaks,
  2. the original notebook is attached to the PDF; and
  3. this extension does not require LaTex.

https://github.com/betatim/notebook-as-pdf

nbinteract

Create interactive webpages from Jupyter Notebooks

https://www.nbinteract.com/

https://github.com/SamLau95/nbinteract

nb_pdf_template

An extended nbconvert template for LaTeX output.

https://github.com/t-makaro/nb_pdf_template

nb2plots

Notebook to reStructuredText converter which uses a modified version of the matplotlib plot directive.

https://github.com/matthew-brett/nb2plots

brole

A Sphinx role for IPython notebooks

https://github.com/matthew-brett/brole

nbsphinx-link

https://github.com/vidartf/nbsphinx-link

Uses nbsphinx, but supports notebooks outside the Sphinx source directory.

See https://github.com/spatialaudio/nbsphinx/pull/33 for some limitations.

bookbook

Uses nbconvert to create a sequence of HTML or a concatenated LaTeX file from a sequence of notebooks.

https://github.com/takluyver/bookbook

jupyter-sphinx

Jupyter Sphinx is a Sphinx extension that executes embedded code in a Jupyter kernel, and embeds outputs of that code in the output document. It has support for rich output such as images, Latex math and even javascript widgets.

https://jupyter-sphinx.readthedocs.io/

https://github.com/jupyter/jupyter-sphinx

Converting Notebooks to reStructuredText

https://github.com/perrette/dimarray/blob/master/docs/scripts/nbconvert_to_rst.py

https://gist.github.com/hadim/16e29b5848672e2e497c (not available anymore)

https://sphinx-ipynb.readthedocs.io/

Further Posts and Issues

https://github.com/ipython/ipython/issues/4936

https://mail.scipy.org/pipermail/ipython-user/2013-December/013490.html (not available anymore)