Skip to content

Instantly share code, notes, and snippets.

@lexnederbragt
Last active October 29, 2022 20:22
Show Gist options
  • Star 10 You must be signed in to star a gist
  • Fork 2 You must be signed in to fork a gist
  • Save lexnederbragt/6fd7186bb1ce7c00e8d3619c700a262b to your computer and use it in GitHub Desktop.
Save lexnederbragt/6fd7186bb1ce7c00e8d3619c700a262b to your computer and use it in GitHub Desktop.
Tools to generate Jupyter Notebooks from plain (markup) text files

Tools to generate Jupyter Notebooks from plain (markup) text files:

(Originally posted on twitter, here incorporating responses)

pandoc

As of version 2.6, there is provisional support for using pandoc using jupyter notebookss (.ipynb files) as input and output format.

Notedown

Markdown to Jupyter Notebook, and back https://github.com/aaren/notedown

Jupinx

Restructured text (rst) to Jupyter Notebook https://github.com/QuantEcon/sphinxcontrib-jupyter, see https://medium.com/quantecon-blog/introducing-jupinx-60ba9fc12f4f

Doconce

Doconce format to Jupyter Notebook and back https://github.com/hplgit/doconce, see http://hplgit.github.io/doconce/doc/pub/manual/manual.html#do2any:ipynb

Sphinx-Gallery Utilities

Python script to Jupyter Notebook http://sphinx-gallery.readthedocs.io/en/latest/index.html, see http://sphinx-gallery.readthedocs.io/en/latest/utils.html?highlight=jupyter#convert-python-scripts-into-jupyter-notebooks

nb2plots

nb2plots converts Jupyter notebooks to ReST files for Sphinx, and back again. https://matthew-brett.github.io/nb2plots/

ox-ipynb

org-file to Jupyter Notebook https://github.com/jkitchin/ox-ipynb

ipyaml

YAML format to Jupyter notebook and back https://github.com/prabhuramachandran/ipyaml

dexy

A bit unclear from the documentation, but seems to be able to generate markdown from Jupyter Notebook, and back? Also other formats? https://github.com/dexy/dexy. Markdown example: https://github.com/ananelson/dexy-experiments/tree/master/ipython-from-markdown. Other exmaples: https://github.com/ananelson/dexy-experiments

ipyrmd

Converts between IPython/Jupyter notebooks and R Markdown documents in both directions. https://github.com/chronitis/ipyrmd

Jupytext

With Jupytext, every Julia, Python or R script, R Markdown or Markdown document becomes a potential Jupyter notebook. Write your notebooks as text, and render them in Jupyter when desired. https://github.com/mwouts/jupytext Blog post: https://towardsdatascience.com/introducing-jupytext-9234fdff6c57.

pynb

Manage Jupyter notebooks as plain Python code with embedded Markdown text. https://github.com/minodes/pynb.

jupyter-format

An Experimental New Storage Format For Jupyter Notebooks. Documentation: https://jupyter-format.readthedocs.io. Repo: https://github.com/mgeier/jupyter-format

nbexplode

A slightly different approach. Explode a notebook into a directory of files, and recombine it to a .ipynb https://github.com/takluyver/nbexplode

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment