nbconvert permite exportar un jupyter (antes llamados ipython) notebook a diferentes formatos, entre ellos markdown. Sin embargo, yo buscaba lo contrario, pasar de un fichero en markdown a notebook.

La razón principal, es que markdown lo edito con cualquier editor de texto, y por eso me resulta muy cómodo documentar en markdown.

Cuando quiero documentar algo relacionado con Python me gusta hacerlo en un notebook de Jupyter. Si lo que documento tiene mucho texto me resulta útil escribirlo en markdown y luego convertirlo a notebook.

¿Cómo lo hago?:

Convirtiendo ficheros Markdown a Jupyter Notebooks con notedown

Aaron O’Leary ha desarrollado la fantástica aplicación notedown que permite pasar de markdown a notebook. Tal como pone en su documentación:

Instalación

pip install notedown

Uso

notedown input.md > output.ipynb

¡ Gracias Aaron, me ha resultado muy útil!