# jupyter/nbconvert

Jupyter Notebook Conversion

Repository: https://github.com/jupyter/nbconvert
Canonical: https://ross.abutalabs.com/products/nbconvert
Homepage: https://nbconvert.readthedocs.io/
Language: Python
License: BSD-3-Clause
License Family: permissive
Last push: 2026-08-03T21:55:04+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 66, longevity 100
- inputs: {"age_days": 4164, "days_push": 30, "days_rel": 148, "gap_med": 68, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1935, forks 611 (observed 2026-08-28T04:05:57.015335+00:00)

## What it is
nbconvert is the Jupyter project's tool for converting .ipynb notebooks into static formats such as HTML, LaTeX, PDF, Reveal.js slides, Markdown, reStructuredText, and executable scripts. It works both as a command-line tool (`jupyter nbconvert`) and as a Python library, using Jinja templates for customizable output.

## Use cases
- convert a jupyter notebook to html
- export ipynb to pdf
- turn notebooks into reveal.js slides
- convert notebook to markdown for a blog
- extract executable python script from a notebook
- batch convert notebooks from the command line
- customize notebook export with jinja templates

## When to choose
- you need to publish or share Jupyter notebooks in static formats like HTML, PDF, or slides
- you want programmatic or CLI-based notebook conversion with customizable templates
- you are building tooling on top of the Jupyter ecosystem that reads or transforms notebooks

## When to avoid
- you need to run or edit notebooks interactively rather than convert them (use Jupyter itself)
- you need conversion of non-notebook documents
- you require formats nbconvert does not support without external tools like pandoc or LaTeX

## Facets
- artifact type: library
- maturity: stable
- function: cli, templating, pdf, markdown, documentation
- domain: developer-tools, data-science, documentation
- platform: python, cli, cross-platform
- tags: jupyter, notebook-conversion, jinja-templates, ipynb, latex, reveal-js, command-line

## Member repositories
- jupyter/nbconvert (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:57.015335+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:08:27.665457+00:00, confidence not recorded.
  - readme: https://github.com/jupyter/nbconvert (fetched 2026-08-28T04:05:57.015335+00:00, sha 7c42a9796a01)
- Data as of 2026-08-30T08:39:29.467469+00:00.