Metadata-Version: 2.1
Name: nbconvert
Version: 6.5.3
Summary: Converting Jupyter Notebooks
Home-page: https://jupyter.org
Author: Jupyter Development Team
Author-email: jupyter@googlegroups.com
License: BSD
Project-URL: Documentation, https://nbconvert.readthedocs.io/en/latest/
Project-URL: Funding, https://numfocus.org/
Project-URL: Source, https://github.com/jupyter/nbconvert
Project-URL: Tracker, https://github.com/jupyter/nbconvert/issues
Keywords: Interactive,Interpreter,Shell,Web
Platform: Linux
Platform: Mac OS X
Platform: Windows
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: lxml
Requires-Dist: beautifulsoup4
Requires-Dist: bleach
Requires-Dist: defusedxml
Requires-Dist: entrypoints (>=0.2.2)
Requires-Dist: jinja2 (>=3.0)
Requires-Dist: jupyter-core (>=4.7)
Requires-Dist: jupyterlab-pygments
Requires-Dist: MarkupSafe (>=2.0)
Requires-Dist: mistune (<2,>=0.8.1)
Requires-Dist: nbclient (>=0.5.0)
Requires-Dist: nbformat (>=5.1)
Requires-Dist: packaging
Requires-Dist: pandocfilters (>=1.4.1)
Requires-Dist: pygments (>=2.4.1)
Requires-Dist: tinycss2
Requires-Dist: traitlets (>=5.0)
Provides-Extra: all
Requires-Dist: pytest ; extra == 'all'
Requires-Dist: pytest-cov ; extra == 'all'
Requires-Dist: pytest-dependency ; extra == 'all'
Requires-Dist: ipykernel ; extra == 'all'
Requires-Dist: ipywidgets (>=7) ; extra == 'all'
Requires-Dist: pre-commit ; extra == 'all'
Requires-Dist: pyppeteer (<1.1,>=1) ; extra == 'all'
Requires-Dist: tornado (>=6.1) ; extra == 'all'
Requires-Dist: sphinx (>=1.5.1) ; extra == 'all'
Requires-Dist: sphinx-rtd-theme ; extra == 'all'
Requires-Dist: nbsphinx (>=0.2.12) ; extra == 'all'
Requires-Dist: ipython ; extra == 'all'
Provides-Extra: docs
Requires-Dist: sphinx (>=1.5.1) ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
Requires-Dist: nbsphinx (>=0.2.12) ; extra == 'docs'
Requires-Dist: ipython ; extra == 'docs'
Provides-Extra: serve
Requires-Dist: tornado (>=6.1) ; extra == 'serve'
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'
Requires-Dist: pytest-cov ; extra == 'test'
Requires-Dist: pytest-dependency ; extra == 'test'
Requires-Dist: ipykernel ; extra == 'test'
Requires-Dist: ipywidgets (>=7) ; extra == 'test'
Requires-Dist: pre-commit ; extra == 'test'
Requires-Dist: pyppeteer (<1.1,>=1) ; extra == 'test'
Provides-Extra: webpdf
Requires-Dist: pyppeteer (<1.1,>=1) ; extra == 'webpdf'

# nbconvert

### Jupyter Notebook Conversion

[![Google Group](https://img.shields.io/badge/-Google%20Group-lightgrey.svg)](https://groups.google.com/forum/#!forum/jupyter)
[![Build Status](https://travis-ci.org/jupyter/nbconvert.svg?branch=main)](https://travis-ci.org/jupyter/nbconvert)
[![Documentation Status](https://readthedocs.org/projects/nbconvert/badge/?version=latest)](https://nbconvert.readthedocs.io/en/latest/?badge=latest)
[![Documentation Status](https://readthedocs.org/projects/nbconvert/badge/?version=stable)](https://nbconvert.readthedocs.io/en/stable/?badge=stable)
[![codecov.io](https://codecov.io/github/jupyter/nbconvert/coverage.svg?branch=main)](https://codecov.io/github/jupyter/nbconvert?branch=main)
[![CircleCI Docs Status](https://circleci.com/gh/jupyter/nbconvert/tree/main.svg?style=svg)](https://circleci.com/gh/jupyter/nbconvert/tree/main)

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 nbconvert --to html mynotebook.ipynb

This command creates an HTML output file named `mynotebook.html`.

## Dev Install

Check if pandoc is installed (`pandoc --version`); if needed, install:

```
sudo apt-get install pandoc
```

Or

```
brew install pandoc
```

Install nbconvert for development using:

```
git clone https://github.com/jupyter/nbconvert.git
cd nbconvert
pip install -e .
```

Running the tests after a dev install above:

```
pip install nbconvert[test]
py.test --pyargs nbconvert
```

## Documentation

- [Documentation for Jupyter nbconvert](https://nbconvert.readthedocs.io/en/latest/)
  [[PDF](https://media.readthedocs.org/pdf/nbconvert/latest/nbconvert.pdf)]
- [nbconvert examples on GitHub](https://github.com/jupyter/nbconvert-examples)
- [Documentation for Project Jupyter](https://jupyter.readthedocs.io/en/latest/index.html)
  [[PDF](https://media.readthedocs.org/pdf/jupyter/latest/jupyter.pdf)]

## Technical Support

- [Issues and Bug Reports](https://github.com/jupyter/nbconvert/issues): A place to report
  bugs or regressions found for nbconvert
- [Community Technical Support and Discussion - Discourse](https://discourse.jupyter.org/): A place for
  installation, configuration, and troubleshooting assistannce by the Jupyter community.
  As a non-profit project and maintainers who are primarily volunteers, we encourage you
  to ask questions and share your knowledge on Discourse.

## Jupyter Resources

- [Jupyter mailing list](https://groups.google.com/forum/#!forum/jupyter)
- [Project Jupyter website](https://jupyter.org)

[jinja]: http://jinja.pocoo.org/