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.
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.
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.
Going the other way
To turn a notebook back into RST, use IPYNB to RST.
RST and IPYNB.What each format is.
The formats
reStructuredText
reStructuredText, the markup of Python documentation and Sphinx.
- Extensions
- .rst
- MIME type
- text
/x -rst - Kind
- Text and data
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.
$ cv convert report.rst report.ipynb$ cv convert report.rst report.ipynbQuestions.What people ask about RST to IPYNB.
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.