Markdown diffs for jupyter notebooks. Makes `diff`ing notebooks less tedious.

md-nb-diffs.md

For sane jupyter notebook diffs

Install the nbconvert package, though you probably already have it if you are using jupyter. Put the nb2md script from below in your path and make it executable (chmod u+x).

nb2md for all your projects

1. Add the following to your ~/.gitattributes file *.ipynb diff=nb2md
2. Run git config --global diff.nb2md.textconv nb2md
3. There is no third step. Go get some 🍦 instead.

nb2md for some projects

1. Edit .gitattributes in the top-level directory of your project and add *.ipynb diff=nb2md
2. add the following to your project's .git/config

 [diff "nb2md"]
        textconv = nb2md

3. There is no third step. Go get some 🍦 instead.

nb2md

#!/bin/sh

jupyter nbconvert --to markdown $1 --stdout --log-level=0