NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #409 most downloaded on PyPI
Convert Jupyter Notebooks (.ipynb files) to other formats.
Latest stable
7.17.2
Last release 1 months ago
12 Oct 2026
Ships unpredictably
gaps range from 9 days to 12 months
Nearly every release is documented
notes for 55 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
11 years old
105 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Fix use of deprecated API and update test matrix by @blink1073 in https://github.com/jupyter/nbconvert/pull/1696
Full Changelog: https://github.com/jupyter/nbconvert/compare/6.3.0...6.4.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
The full list of changes can be seen on the 6.4.0 milestone
The full list of changes can be seen on the 6.3.0 milestone
The full list of changes can be seen on the 6.3.0 milestone
Nothing published for this version
The full list of changes can be seen on the 6.2.0 milestone
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
This release is mostly a long list of bug fixes and capability additions. Thanks to the many contributors for helping Improve nbconvert!
This release is mostly a long list of bug fixes and capability additions. Thanks to the many contributors for helping Improve nbconvert!
The following 31 authors contributed 81 commits.
Nothing published for this version
Primarily a release addressing template extensions issues reported since 6.0 launched.
Primarily a release addressing template extensions issues reported since 6.0 launched.
A range of bug fixes for webpdf exports
A range of bug fixes for webpdf exports
Revert networkidle2 change which caused custom cdn-fetched widgets in webpdf
The webpdf exporters does not add pagebreaks anymore before reaching the maximum height allowed by Adobe #1402
Execute preprocessor no longer add illegal execution counts to markdown cells #1396
Execute preprocessor no longer add illegal execution counts to markdown cells #1396
A patch for a few minor issues raised out of the 6.0 release.
A patch for a few minor issues raised out of the 6.0 release.
preprocess_cell function to
overwrite #1380A quick patch to fix an issue with get_exporter #1367
A quick patch to fix an issue with get_exporter #1367
Inkscape 1.0 is now supported, which had some breaking changes that prevented 5.x versions of nbconvert from converting documents on some systems that…
The following authors and reviewers contributed the changes for this release -- Thanks you all!
Nbconvert 6.0 is a major release of nbconvert which includes many significant changes.
template_path has become template_paths. If referring to a 5.x
style .tpl template use the full path with the template_file
argument to the file. On the command line the pattern is
--template-file=<path/to/file.tpl>.jupyter nbconvert --to html --template classic
nbconvert/templates and has the form of a directory containing all
resources. Templates specify their base template as well as other
configuration parameters in a conf.json at the root of the
template directory.jupyter nbconvert --to html --template reveal
The --to slides exporter is still supported for convenience.
We merged 105 pull requests! Rather than enumerate all of them we'll link to the github page which contains the many smaller impact improvements.
The full list can be seen on GitHub
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
The following authors and reviewers contributed the changes for this release -- Thanks you all!
The following authors and reviewers contributed the changes for this release -- Thanks you all!
RegExRemove preprocessor now removes cells regardless of cell outputs. Before this only cells that had outputs were filtered.
Fix backwards incompatibility with markdown2html #1022
The following 24 authors and reviewers contributed 224 commits -- Thank you all!
The full list of changes they made can be seen on GitHub
The jupyter_client dependency is now pinned to >5.3.1. This is done
to support the Parallel NBConvert below, and
future versions may require interface changes from that version.
NBConvert --execute can now be run in parallel via threads,
multiprocessing, or async patterns! This means you can now parallelize
nbconvert via a bash loop, or a python concurrency pattern and it should
be able to execute those notebooks in parallel.
Kernels have varying support for safe concurrent execution. The ipython kernel (ipykernel version 1.5.2 and higher) should be safe to run concurrently using Python 3. However, the Python 2 ipykernel does not always provide safe concurrent execution and sometimes fails with a socket bind exception. Unlike ipykernel which is maintained by the project, other community-maintained kernels may have varying support for concurrent execution, and these kernels were not tested heavily.
Issues for nbconvert can be viewed here: #1018, and #1017
This release completely rewrote the execution loop responsible for monitoring kernel messages until cell execution is completed. This removes an error where kernel messages could be dropped if too many were posted too quickly. Furthermore, the change means that messages are not buffered. Now, messages can be logged immediately rather than waiting for the cell to terminate.
See #994 for exact code changes if you're curious.
store_history option to preprocess_cell and run_cell
#1055setup_preprocessor passes kwargs to start_new_kernel
#1021export_from_notebook names #1027test_run_notebooks #1015This tag is used to provide a working documentation build for RTD.
This tag is used to provide a working documentation build for RTD.
The following 18 authors contributed 144 commits -- Thank you all!
The full list of changes they made can be seen on GitHub
Python 3.4 support was dropped. Many of our upstream libraries stopped supporting 3.4 and it was found that serious bugs were being caught during testing against those libraries updating past 3.4.
See #979 for details.
Now when a notebook executing contains Jupyter Widgets, the state of all the widgets can be stored in the notebook's metadata. This allows rendering of the live widgets on, for instance nbviewer, or when converting to html.
You can tell nbconvert to not store the state using the
store_widget_state argument:
jupyter nbconvert --ExecutePreprocessor.store_widget_state=False --to notebook --execute mynotebook.ipynb
This widget rendering is not performed against a browser during
execution, so only widget default states or states manipulated via user
code will be calculated during execution. %%javascript cells will
execute upon notebook rendering, enabling complex interactions to
function as expected when viewed by a UI.
If you can't view widget results after execution, you may need to
select File --> Trust Notebook in the menu.
See #779, #900, and #983 for details.
Based on monkey patching required in
papermill
the run_cell code path in the ExecutePreprocessor was reworked to
allow for accessing individual message parses without reimplementing the
entire function. Now there is a process_message function which take a
ZeroMQ message and applies all of its side-effect updates on the
cell/notebook objects before returning the output it generated, if it
generated any such output.
The change required a much more extensive test suite covering cell execution as test coverage on the various, sometimes wonky, code paths made improvements and reworks impossible to prove undamaging. Now changes to kernel message processing has much better coverage, so future additions or changes with specs over time will be easier to add.
When running out of memory on a machine, if the kernel process was killed by the operating system it would result in a timeout error at best and hang indefinitely at worst. Now regardless of timeout configuration, if the underlying kernel process dies before emitting any messages to the effect an exception will be raised notifying the consumer of the lost kernel within a few seconds.
See #959, #971, and #998 for details
The latex template was long overdue for improvements. The default template had a rewrite which makes exports for latex and pdf look a lot better. Code cells in particular render much better with line breaks and styling the more closely matches notebook browser rendering. Thanks t-makaro for the efforts here!
See #992 for details
Thanks to the following 11 authors who contributed 57 commits.
Thanks to the following 11 authors who contributed 57 commits.
Nothing published for this version
Ppdate log.warn (deprecated) to log.warning #804
Python 3.3 support was dropped. The version of python is no longer common and new versions have many fixes and interface improvements that warrant the change in support.
See #843 for implementation details.
There were a few new metadata fields which are now respected in nbconvert.
nb.metadata.authors metadata attribute will be respected in latex
exports. Multiple authors will be added with , separation against
their names.
nb.metadata.title will be respected ahead of nb.metadata.name for
title assignment. This better matches with the notebook format.
nb.metadata.filename will override the default
output_filename_template when extracting notebook resources in the
ExtractOutputPreprocessor. The attribute is helpful for when you want
to consistently fix to a particular output filename, especially when you
need to set image filenames for your exports.
The raises-exception cell tag
(nb.cells[].metadata.tags[raises-exception]) allows for cell
exceptions to not halt execution. The tag is respected in the same way
by nbval and other
notebook interfaces. nb.metadata.allow_errors will apply this rule for
all cells. This feature is toggleable with the force_raise_errors
configuration option. Errors from executing the notebook can be allowed
with a raises-exception tag on a single cell, or the allow_errors
configurable option for all cells. An allowed error will be recorded in
notebook output, and execution will continue. If an error occurs when it
is not explicitly allowed, a 'CellExecutionError' will be raised. If
force_raise_errors is True, CellExecutionError will be raised for
any error that occurs while executing the notebook. This overrides both
the allow_errors option and the raises-exception cell tags.
See #867, #703, #685, #672, and #684 for implementation changes.
The kernel manager can now be optionally passed into the
ExecutePreprocessor.preprocess and the executenb functions as the
keyword argument km. This means that the kernel can be configured as
desired before beginning preprocessing.
This is useful for executing in a context where the kernel has external dependencies that need to be set to non-default values. An example of this might be a Spark kernel where you wish to configure the Spark cluster location ahead of time without building a new kernel.
Overall the ExecutePreprocessor has been reworked to make it easier to use. Future releases will continue this trend to make this section of the code more inheritable and reusable by others. We encourage you read the source code for this version if you're interested in the detailed improvements.
See #852 for implementation changes.
Exporters are now exposed for front-ends to consume, including classic notebook. As an example, this means that latex exporter will be made available for latex 'text/latex' media type from the Download As interface.
See #759 and #864 for implementation changes.
Template exporters can now be assigned raw templates as string
attributes by setting the raw_template variable.
class AttrExporter(TemplateExporter):
# If the class has a special template and you want it defined within the class
raw_template = """{%- extends 'rst.tpl' -%}
{%- block in_prompt -%}
raw template
{%- endblock in_prompt -%}
"""
exporter_attr = AttrExporter()
output_attr, _ = exporter_attr.from_notebook_node(nb)
assert "raw template" in output_attr
See #675 for implementation changes.
The --no-input will hide input cells on export. This is great for
notebooks which generate "reports" where you want the code that was
executed to not appear by default in the extracts.
An alias for notebook was added to exporter commands. Now --to ipynb
will behave as --to notebook does.
See #825 and #873 for implementation changes.
--no-input) #825--to ipynb for notebook exporter #873export_from_notebook #864nb.metadata.authors for LaTeX author line
#867\mathscr #830nb.metadata.title is set, default to that for notebook
#672--to html now
required)font-awesome version for slides #793--inplace command line flag. #839usage.rst #863reveal_url_prefix #844onlyif_cmds_exist decorator to test-specific utils
#854MANIFEST.in updated to include LICENSE and scripts/ when creating sdist. #666
LICENSE and scripts/ when
creating sdist. #666For removing individual elements from notebooks, we need a way to signal to nbconvert that the elements should be removed. With this release, we intro
For removing individual elements from notebooks, we need a way to signal to nbconvert that the elements should be removed. With this release, we introduce the use of tags for that purpose.
Tags are user-defined strings attached to cells or outputs. They are stored in cell or output metadata. For more on tags see the nbformat docs on cell metadata.
Usage:
For removing an entire cell, the cell input, or all cell outputs apply the tag to the cell.
For removing individual outputs, put the tag in the output metadata
using a call like
display(your_output_element, metadata={tags=[<your_tags_here>]}).
NB: Use different tags depending on whether you want to remove the entire cell, the input, all outputs, or individual outputs.
The following traitlets remove elements of different kinds:
remove_cell_tags: removes cellsremove_input_tags: removes inputsremove_all_outputs_tag: removes all outputsremove_single_output_tag: removes individual outputsbrowser in ServePostProcessor
#618--clear-output command line flag to clear output in-place
#619TagRemovePreprocessor.
#640, #643nbconvert.preprocessors #656ExecutePreprocessor #656\\(\\) & \\[\\] (both nbconvert & pandoc)
#609 #617execute_reply and error messages
#642deprecated nose test features removed #519
In this release (along with the usual bugfixes and documentation improvements, which are legion) we have a few new major features that have been requested for a long time:
You now have the ability to remove input or output from code cells, markdown cells and the input and output prompts. The easiest way to access all of these is by using traitlets like TemplateExporter.exclude_input = True (or, for example HTMLExporter.exclude_markdown = True if you wanted to make it specific to HTML output). On the command line if you just want to not have input or output prompts just use --no-prompt.
You can now use the executenb function to execute notebooks as though you ran the execute preprocessor on the notebooks. It returns the standard notebook and resources options.
This removes cells based on their matching a regex pattern (by default, empty cells). This is the RegexRemovePreprocessor.
Now there is an entrypoint for having an exporter specific to the type of script that is being exported. While designed for use with the IRkernel in particular (with a script exporter focused on exporting R scripts) other non-python kernels that wish to have a language specific exporter can now surface that directly.
executenb
#573HTMLExporter.anchor_link_text #522resolve_references filter in
report.tplx #577< inside math formulas when converting to
html #514This release has been larger than previous releases. In it 33 authors contributed a total of 546 commits.
Many thanks to the following individuals who contributed to this release (in alphabetical order):
fix version numbering because of incomplete previous version number
improved CSS (specifically tables, in line with notebook) #498
Use xelatex by default for latex export, improving unicode and font support.
xelatex by default for latex
export, improving unicode and font support.convert_pandoc filter to reduce the need to hard-code
lists of filters in templates.Nothing published for this version
added live widget rendering for html output, nbviewer by extension
Custom Exporters can be provided by external packages, and registered with nbconvert via setuptools entrypoints.
Custom Exporters can be provided by external packages, and registered
with nbconvert via setuptools entrypoints.--stdin option (write into
notebook basename)--execute.setuptools fixes for entrypoints on Windows
4.0 on GitHub
Nothing published for this version
One column per quarter.