---
id: nbconvert
version: "7.17.1"
license: BSD 3-Clause License - Copyright (c) 2001-2015, IPython Development Team - Copyright (c) 2015-, Jupyter Development Team All rights reserved. Redistribution and use in source and binary forms, with… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# nbconvert — Convert Jupyter Notebooks (.ipynb files) to other formats.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install nbconvert
uv add nbconvert
poetry add nbconvert

## Description

# nbconvert

### Jupyter Notebook Conversion

[![Build Status](https://github.com/jupyter/nbconvert/actions/workflows/tests.yml/badge.svg?query=branch%3Amain++)](https://github.com/jupyter/nbconvert/actions/workflows/tests.yml/badge.svg?query=branch%3Amain++)
[![Documentation Status](https://readthedocs.org/projects/nbconvert/badge/?version=latest)](https://nbconvert.readthedocs.io/en/latest/?badge=latest)

The **nbconvert** tool, `jupyter nbconvert`, converts notebooks to various other
formats via [Jinja] templates. The nbconvert tool allows you to convert an
`.ipynb` notebook file into various static formats including:

- HTML
- LaTeX
- PDF
- Reveal JS
- Markdown (md)
- ReStructured Text (rst)
- executable script

## Usage

From the command line, use nbconvert to convert a Jupyter notebook (_input_) to a
a different format (_output_). The basic command structure is:

```
$ jupyter nbconvert --to <output format> <input notebook>
```

where `<output format>` is the desired output format and `<input notebook>` is the
filename of the Jupyter notebook.

### Example: Convert a notebook to HTML

Convert Jupyter notebook file, `mynotebook.ipynb`, to HTML using:

```
$ jupyter...

## AI interpretation — verify before relying

nbconvert converts Jupyter notebooks (.ipynb files) to multiple static formats including HTML, LaTeX, PDF, Markdown, and executable scripts via Jinja templates.

Verdict: nbconvert is a mature, actively maintained tool from the Jupyter project with permissive licensing and low install friction. No known vulnerabilities and broad format support make it a reliable choice for notebook conversion workflows.

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