转换为（不是从）ipython Notebook格式

Question

IPython Notebook带有nbconvert，可以 将 笔记本 导出
为其他格式。但是，如何在相反方向转换文本？我之所以问，是因为我已经有了不同格式的资料和良好的工作流程，但是我想利用Notebook的交互式环境。

可能的解决方案：可以通过导入.py文件来创建笔记本，并且文档指出，当nbconvert将笔记本导出为python脚本时，它将指令嵌入到可用于重新创建笔记本的注释中。但是这些信息带有关于此方法局限性的免责声明，并且在我能找到的任何地方都没有记录接受的格式。（奇怪的是，在描述笔记本的JSON格式的部分中显示了一个示例）。谁能提供更多信息，或者提供更好的选择？

编辑（2016年3月1日）： 接受的答案不再起作用，因为Notebook API的版本4不支持此输入格式。 我添加
了一个自我解答，
展示了如何使用当前（v4）API导入笔记本。（我不接受当前的答案，因为它可以解决我当时的问题，并指出我在自我答案中使用的资源。）

由于接受的答案中的代码不再起作用，因此我添加了此自我答案，该答案显示了如何使用当前（v4）API导入笔记本。

输入格式
IPython Notebook API的版本2和3可以导入带有特殊结构注释的python脚本，并根据需要将其分解为单元格。这是一个示例输入文件（此处为原始文档）。前两行被忽略，并且是可选的。（事实上，读者会忽略coding:和 文件中的行的任何地方。）

# -*- coding: utf-8 -*-
# <nbformat>3.0</nbformat>

# <markdowncell>

# The simplest notebook. Markdown cells are embedded in comments, 
# so the file is a valid `python` script. 
# Be sure to **leave a space** after the comment character!

# <codecell>

print("Hello, IPython")

# <rawcell>

# Raw cell contents are not formatted as markdown

（API还接受过时的指令 和 ，它们会立即转换为其他类型。）

如何汇入
由于某种原因，Notebook API的版本4不支持此格式。它仍然是一种不错的格式，因此通过导入版本3并进行升级来支持它是值得的麻烦。原则上，这只是两行代码以及I / O：

from IPython.nbformat import v3, v4

with open("input-file.py") as fpin:
    text = fpin.read()

nbook = v3.reads_py(text)
nbook = v4.upgrade(nbook)  # Upgrade v3 to v4

jsonform = v4.writes(nbook) + "\n"
with open("output-file.ipynb", "w") as fpout:
    fpout.write(jsonform)

但是没有那么快！实际上，笔记本API有一个令人讨厌的错误：如果输入中的最后一个单元格是降价单元格，v3.reads_py()则会丢失它。最简单的解决方法是 在末尾添加一个假单元：该错误将其删除，每个人都很高兴。在text转到之前，请执行以下操作v3.reads_py()：

text += """
# <markdowncell>

# If you can read this, reads_py() is no longer broken! 
"""

Answer 1

以下内容适用于IPython 3，但不适用于IPython 4。

IPython
API具有用于读取和写入笔记本文件的功能。您应该使用此API，而不是直接创建JSON。例如，以下代码片段将脚本test.py转换为Notebook
test.ipynb。

import IPython.nbformat.current as nbf
nb = nbf.read(open('test.py', 'r'), 'py')
nbf.write(nb, open('test.ipynb', 'w'), 'ipynb')

关于nbf.read理解的.py文件的格式，最好仅查看解析器类IPython.nbformat.v3.nbpy.PyReader。可以在这里找到代码（它不是很大）：

https://github.com/ipython/ipython/blob/master/jupyter_nbformat/v3/nbpy.py

编辑： 此答案最初是为IPyhton 3编写的。我不知道如何使用IPython
4正确执行此操作。这是上面链接的更新版本，指向nbpy.pyIPython 3.2.1发行版中的版本：

https://github.com/ipython/ipython/blob/rel-3.2.1/IPython/nbformat/v3/nbpy.py

基本上，您使用特殊注释，例如# <codecell>或# <markdowncell>来分隔单个单元格。查看中的line.startswith语句以PyReader.to_notebook获取完整列表。