如何将ReStructuredText文档转换为ipython笔记本？

Question

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?

Answer 1

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

Answer 2

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

Answer 3

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