Overview

Overview#

Jupyter Notebook Publishing

A Sphinx and Docutils extension for compiling Jupyter Notebooks into high quality documentation formats.

Get Started


Write

Mix Jupyter notebooks with text-based notebooks, Markdown and RST documents.
Use MyST Markdown syntax to support technical authoring features such as cross-referencing, figures, and admonitions.

The basics
Compute

Generate dynamic outputs using Jupyter kernels, with configurable execution handling.
Cache execution outputs, for fast re-builds.

Execute and cache
Render

Convert Jupyter execution outputs to rich embedded content.
Insert computed variables within the document flow.
Build single or collections of documents into multiple formats (HTML, PDF, …).

Format code cells

MyST-NB is a module within the Executable Books Project, an international collaboration to build open source tools that facilitate publishing computational narratives using the Jupyter ecosystem. It is also a core component of Jupyter Book.

Check out the Gallery of Jupyter Books, for inspiration from across the community.

See also, the MyST-Markdown VS Code extension and jupyterlab-myst, for editor tools to author your notebooks.