Convert RST to IPYNB

Turn RST files into IPYNB. A Jupyter notebook with the text in Markdown cells; only code blocks with the class code become code cells, and outputs are empty.

Converted in an isolated sandbox on our serversDeleted after 24 hours

Drop RST files on the dialor turn it to pick what to do

Your reStructuredText as a notebook.The text becomes Markdown cells, and marked code blocks become code cells.

  1. What you get

    One IPYNB file, a Jupyter notebook that holds your RST document. Most of the text goes into Markdown cells.

    Only code blocks with the class code become code cells. Every code cell has empty outputs, so nothing is shown under the code until you run it.

  2. What changes or is left behind

    Directives that only Sphinx knows, such as toctree, keep just their text. Their special behavior is not carried over.

    Comments are dropped. Images that were not uploaded become their description, so the notebook shows the description in place of the picture.

  3. Going the other way

    To turn a notebook back into RST, use IPYNB to RST.

RST and IPYNB.What each format is.

The formats

From · RST

reStructuredText

reStructuredText, the markup of Python documentation and Sphinx.

Extensions
.rst
MIME type
text/x-rst
Kind
Text and data
To · IPYNB

Jupyter Notebook

Jupyter notebooks. Code cells, their outputs and Markdown notes in one JSON file.

Extensions
.ipynb
MIME type
application/x-ipynb+json
Kind
Text and data

In your code.The same RST to IPYNB conversion through the API, for your app or your agent.

terminal
$ cv convert report.rst report.ipynb
$ cv convert report.rst report.ipynb

Questions.What people ask about RST to IPYNB.

01OF 04

Code blocks with the class code. The rest of the text goes into Markdown cells.

No. The outputs of every code cell are empty.

It keeps just its text. The directive itself is not kept, because only Sphinx knows it.

No. Comments are dropped from the notebook.

More conversions.Other ways in and out of RST and IPYNB.