[IPython-dev] notebooks embedded in sphinx

Jake Vanderplas vanderplas at astro.washington.edu
Mon Sep 24 21:36:22 EDT 2012

Hi all,
I've been thinking about the best way to embed notebooks in sphinx 
documentation using nbconvert. I've opened an initial PR at 
The current version is a simple sphinx extension based on the raw html 
directive, but results in non-standard html that may not work in some 
browsers (i.e., style tags outside the html header).

I'm still not sure the best way to progress, but I'd appreciate any 
feedback or ideas.

More information about the IPython-dev mailing list