zoj613/note2mark

A simple makefile used to convert files/directories of iPython notebooks to markdown format and viseversa

note2mark

A simple makefile used to convert files/directories of iPython notebooks to markdown format and vise versa

Requirements

It is assumed you have notedown already installed in your python environment. If not then install it with:

pip install notedown

Usage

Assuming you have the Makefile in your current directory then to convert an ipython notebook file into a markdown file then run:

make markdown path=<path to .ipynb file>

All files in a directory can be converted to a markdown file using

make markdown path=<path to directory. It must end with "/">

Similarly for a markdown to notebook conversion the following commands can be ran:

make notebook path=<path to .md file>
make notebook path=<path to directory with .md files. It must end with "/">

note2mark's Issues

Markdown conversion doesn't work for notebooks with spaces in their name

For example,
bash make markdown path='first second.ipynb'
or
bash make markdown path=first\ second.ipynb

Will fail with:
make: *** No rule to make target "first", needed by 'markdown'. Stop.

Looks like somewhere second is being chopped off, perhaps by a split on spaces.