[IPython-dev] notebooks embedded in sphinx

Jake Vanderplas vanderplas@astro.washington....
Mon Sep 24 20:36:22 CDT 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