This notebook is part of the jupyter_format
documentation:
https://jupyter-format.readthedocs.io/.
Notebook format conversions with nbconvert
¶
During the installation of jupyter_format
(see Installation),
so-called "entry points" for nbconvert
are configured automatically.
You can convert .ipynb
notebooks to .jupyter
notebooks with
python3 -m nbconvert --to jupyter my-old-notebook.ipynb
To convert a .jupyter
notebook to any format supported by nbconvert
,
just append -from-jupyter
to the desired format.
For example, you can convert a .jupyter
notebook
to the traditional .ipynb
format:
python3 -m nbconvert --to ipynb-from-jupyter my-new-notebook.jupyter
Or you can convert a .jupyter
file to an HTML file:
python3 -m nbconvert --to html-from-jupyter my-new-notebook.jupyter
Same for slides-from-jupyter
, latex-from-jupyter
, pdf-from-jupyter
etc.
But enough for the theory, let's try it with this very notebook, shall we?
!python3 -m nbconvert --to ipynb-from-jupyter nbconvert.jupyter --output=my-new-notebook
Just to make sure it is actually using Jupyter's JSON format, let's peek at the beginning of the file:
!head my-new-notebook.ipynb
Here's a link to the new file for your perusal: my-new-notebook.ipynb.
Now let's convert this back to .jupyter
:
!python3 -m nbconvert --to jupyter my-new-notebook.ipynb
Again, we take a peek:
!head my-new-notebook.jupyter
And a link for closer inspection: my-new-notebook.jupyter.
Finally, let's try to convert this .jupyter
file to an HTML page:
!python3 -m nbconvert --to html-from-jupyter my-new-notebook.jupyter
from IPython.display import IFrame
IFrame('my-new-notebook.html', width='100%', height=350)
And for completeness' sake, a link: my-new-notebook.html.