---
id: jupyter-book
version: "2.1.6"
license: unclear
license_treatment: permissive
maintenance: active
---

# jupyter-book — Create computational narratives that are reusable, reproducible, and interactive.

License: permissive · Maintenance: active · Downloads: 342.6K/mo

## What it is and what it does

Jupyter Book is a tool for building publication-quality books and documents from computational material—Markdown files and Jupyter notebooks mixed together. It lets you write content in either format, embed executable code cells, add rich syntax like citations and cross-references, then build the whole thing into a web-based interactive book and a PDF, all from a single command.

The package sits on top of standard Jupyter infrastructure (ipykernel, jupyter-core, jupyter-server) and handles the orchestration of running code, caching outputs, and converting the result to multiple formats. It's designed for technical documentation, educational materials, and research narratives where you want the source to be both readable and executable.

Use it for:

- Build a textbook or course material where students can read and run code examples interactively in the browser.
- Publish research findings as a narrative document with embedded analysis code and figures that regenerate on rebuild.
- Create technical documentation that mixes prose, code samples, and live outputs in a single cohesive book.
- Generate a PDF report from a collection of Jupyter notebooks with consistent styling and cross-references.
- Maintain a reproducible project narrative where the book source is version-controlled alongside the code it documents.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Jupyter Book converts Markdown files and Jupyter notebooks into publication-quality books and documents, executing embedded code cells and generating both interactive web books and PDFs.

Yes. Jupyter Book is actively maintained, has low install friction, carries no known vulnerabilities, and solves a real problem for anyone building technical books or reproducible narratives from notebooks and Markdown. The permissive BSD license poses no barrier. Install it if you need to publish computational content as a polished book or document.

## Install

pip install jupyter-book
uv add jupyter-book
poetry add jupyter-book

## Installing jupyter-book

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release; depends on standard Jupyter infrastructure (ipykernel, jupyter-core, jupyter-server) plus platformdirs and nodeenv.

License in practice: BSD License (permissive) means you can use, modify, and distribute this package with minimal restrictions, provided you include the license notice.

Quickstart:

pip install jupyter-book
jupyter-book build ./my-book

Requires Python 3.9 or later; nodeenv dependency may require Node.js tooling to be available on your system.

Verify before relying:

- Whether nodeenv is a runtime or build-time dependency and what Node.js version it requires
- Whether the PDF output requires additional system dependencies (e.g., LaTeX, Chromium)
- Performance characteristics when building large books with many code cells

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 342.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter notebook to book, markdown to publication pdf, computational narrative publishing, jupyter documentation generator, code-integrated book builder, executable notebook publishing, jupyter content to html and pdf, documentation-generation, jupyter-ecosystem, reproducible-publishing

[View on SkillFed](https://skillfed.io/packages/jupyter-book) · [View on PyPI](https://pypi.org/project/jupyter-book/)