nbconvert
Convert Jupyter Notebooks (.ipynb files) to other formats.
Decision gist · record as of 2026-08-14
Yes. nbconvert is a mature, actively maintained tool with no security vulnerabilities, low install friction, and broad format support. It is the standard way to export Jupyter notebooks and integrates cleanly with the Jupyter ecosystem. Install it if you need to convert notebooks to static formats or automate notebook publishing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- pandoc must be installed separately on your system (check with `pandoc --version`; install via `apt-get install pandoc` or `brew install pandoc`).
- Low friction install with 15 runtime dependencies managed as a pure Python wheel.
- Actively maintained with a release 128 days ago; no known security vulnerabilities.
License · maintenance · safety
permissive license (permissive) — BSD 3-Clause License (permissive): you may use, modify, and distribute nbconvert freely in commercial and private projects, provided you retain copyright notices and include the license text.
last release 2026-04-08 (128 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 67,755,990 downloads/mo, #479 on PyPI
Alternatives
Verify before relying
pip install nbconvert
jupyter nbconvert --to html mynotebook.ipynb- Whether all output formats (HTML, LaTeX, PDF, Reveal.js, Markdown, ReStructuredText, executable script) are equally well-supported or if some require additional system dependencies.
- Performance characteristics when converting large or complex notebooks.
What it is and what it does
nbconvert is a command-line tool and Python library that transforms Jupyter notebooks into multiple static output formats. It uses Jinja templates to customize the conversion process and integrates with the Jupyter ecosystem via dependencies like nbformat, nbclient, and jupyter-core. The tool is commonly used to publish notebooks as HTML documentation, generate PDF reports, create presentation slides, or export code as executable scripts.
The package is designed for developers, researchers, and system administrators who need to automate notebook conversion workflows or embed conversion logic in larger applications. It handles the full pipeline from parsing notebook JSON through rendering to the target format, with built-in support for syntax highlighting via Pygments and HTML sanitization via bleach.
Use it for
- Export a Jupyter notebook to HTML for sharing as a static web page or embedding in documentation.
- Generate PDF reports from notebooks for distribution to non-technical stakeholders.
- Convert notebooks to Markdown for version control and integration with static site generators.
- Create presentation slides from notebook content using Reveal.js output format.
- Extract executable Python scripts from notebooks for batch processing or CI/CD pipelines.
- Automate bulk conversion of multiple notebooks in a research or educational workflow.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
nbconvert is a mature, actively maintained tool with no security vulnerabilities, low install friction, and broad format support. It is the standard way to export Jupyter notebooks and integrates cleanly with the Jupyter ecosystem. Install it if you need to convert notebooks to static formats or automate notebook publishing.
Install
nbconvert on PyPI
Before you install
Low friction install with 15 runtime dependencies managed as a pure Python wheel. Actively maintained with a release 128 days ago; no known security vulnerabilities.
pandoc must be installed separately on your system (check with `pandoc --version`; install via `apt-get install pandoc` or `brew install pandoc`).
License in practice
BSD 3-Clause License (permissive): you may use, modify, and distribute nbconvert freely in commercial and private projects, provided you retain copyright notices and include the license text.
Quickstart
pip install nbconvert
jupyter nbconvert --to html mynotebook.ipynb
Verify before relying
- Whether all output formats (HTML, LaTeX, PDF, Reveal.js, Markdown, ReStructuredText, executable script) are equally well-supported or if some require additional system dependencies.
- Performance characteristics when converting large or complex notebooks.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 15 packagesbeautifulsoup4bleachdefusedxmlimportlib-metadatajinja2jupyter-corejupyterlab-pygmentsmarkupsafemistunenbclientnbformatpackagingpandocfilterspygmentstraitlets |
| Maintenance | Actively maintained 128 days since the last release |
| First released | |
| Downloads | 67,755,990 / month, #479 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersIntended Audience :: Science/ResearchIntended Audience :: System AdministratorsLicense :: OSI Approved :: BSD LicenseProgramming Language :: PythonProgramming Language :: Python :: 3 |
Evidence: nbconvert-7.17.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “jupyter notebook to html conversion”
- nbconvertnbconvert converts Jupyter notebooks (.ipynb files) to static formats…
- nbsphinxnbsphinx is a Sphinx extension that parses Jupyter Notebook files…
- voilaVoilà converts Jupyter notebooks into standalone web applications…
Give your agent the search over MCP, or paste the wish link into any chat.
More Markup packages
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
A Python markdown parser that converts markdown to HTML following the CommonMark specification, with support for plugins and custom syntax rules.
Install it if you need reliable markdown-to-HTML conversion.
Beautiful Soup parses HTML and XML documents into a navigable tree, providing Pythonic methods to search, iterate, and modify the parsed content.
Install it if you need to parse or extract data from markup documents.
et_xmlfile writes large XML files with minimal memory overhead by serializing elements to disk as they are created, rather than holding the entire tree in memory.
Install it if incremental XML writing fits your use case; skip it if your XML documents are small or you already use lxml.
Parses and edits TOML files while preserving formatting, comments, and structure, then serializes them back with layout intact.
Install it if you're building tools that touch TOML files and user readability of the source matters.
Parses Python docstrings in ReST, Google, Numpydoc, and Epydoc formats, extracting structured information like descriptions, parameters, return types, and exceptions.
Install it if you need to programmatically read and extract structured data from Python docstrings.
See also ipynbname · jupyter-book · mkdocs-jupyter · nbclient · nbformat · jupytext · myst-nb · nbtoolbelt · importnb · notebook