CODEWITHSUNDEEP
pythondocumentationipythonrestructuredtext
Private
Private

Reputation: 2694

How to convert ReStructuredText docs to ipython notebooks?

A lot of documentation in the python community these days is written in ReStructuredText. I want to convert some of these docs to ipython notebooks so that it is possible to not just read the examples in the docs, but interact with them immediately.

How can I convert ReStructuredTexts to ipython notebooks? Is there any way to do this? Maybe using pandoc as an intermediate step?

I have already read some docs on how to convert ipython notebooks to other formates, but I am interested in doing it the other way around, from rst to iptyhon. Any ideas?

Upvotes: 8

Views: 2019

Answers (3)

akaihola
akaihola

Reputation: 26835

In addition to sphinxcontrib-jupyter/jupinx, Google found rst2ipynb. It seems to use pandoc. I haven't yet tried it myself though.

Upvotes: 2

sanguineturtle
sanguineturtle

Reputation: 1455

If you are still looking for a solution, we are building a Sphinx extension to convert a collection of RST files to Jupyter notebooks.

sphinxcontrib-jupyter

Upvotes: 2

Chris
Chris

Reputation: 11

There's a package for markdown to ipynb. notedown 1.0.3. You could use pandoc for rst to md then md to ipynb.

Upvotes: 1

Related Questions