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

8 投票
3 回答
1974 浏览
提问于 2025-04-18 00:48

现在,很多Python社区的文档都是用ReStructuredText这种格式写的。我想把这些文档转换成ipython笔记本,这样不仅可以阅读文档中的例子,还能立即与它们互动。

那我该怎么把ReStructuredText转换成ipython笔记本呢?有没有什么方法可以做到这一点?也许可以使用pandoc作为中间步骤?

我已经看过一些关于如何把ipython笔记本转换成其他格式的文档,但我想做的是反向操作,从rst转换成ipython。有没有什么好主意?

3 个回答

1

有一个工具可以把markdown格式的文件转换成ipynb格式,叫做 notedown 1.0.3。你也可以先用pandoc把rst格式转换成markdown格式,然后再把markdown转换成ipynb格式。

2

除了 sphinxcontrib-jupyterjupinx,谷歌还发现了一个叫 rst2ipynb 的工具。这个工具似乎是用 pandoc 制作的。不过我自己还没有试过。

2

如果你还在寻找解决办法,我们正在开发一个Sphinx的扩展,可以把一堆RST文件转换成Jupyter笔记本。

sphinxcontrib-jupyter

撰写回答