How to export an IPython notebook to HTML for a blog post?

Question

What is the best way to get an ipython notebook into html format for use in a blog post?

It is easy to turn an ipython notebook into a PDF, but I'd rather publish as an html notebook.

I've found that if I download the notebook as a .ipynb file, then load it onto gist, then look at it with the ipython notebook viewer (nbviewer.ipython.org), THEN grab the html source, I can paste it into a blog post (or just load it as html anywhere) and it looks about right. However, if I use the "print view" option directly from ipython, the source contains a bunch of javascript rather than the processed html, which is not useful since the images and text are not directly included.

The %pastebin magic is also not particularly helpful for this task, since it pastes the python code and not the ipython notebook formatted code.

EDIT: Note that this is under development; see the comments under the accepted answer.

EDIT May 2 2014: As per Nathaniel's comment, a new answer is needed for ipython 2.0

Change made. There is probably an answer hidden in Damian Avila's blog: http://www.damian.oquanta.info/posts/deploy-your-nikola-powered-blog-content-from-the-ipython-notebook.html — keflavich, May 02 '14 at 07:32

score 17 · Answer 1 · answered Sep 19 '12 at 23:42

17

The right way is described in: http://blog.fperez.org/2012/09/blogging-with-ipython-notebook.html. Then you can do nbconvert -f blogger-html your_notebook.ipynb to get the html code for your post.

answered Sep 19 '12 at 23:42

Daniel

26,899
12
60
88

1

nbconvert got moved to the IPython repo https://github.com/ipython/ipython/tree/master/IPython/nbconvert – Tim Swast Jul 11 '13 at 20:28
And now it's part of the official ipython 1.0 release. – Mike Sep 09 '13 at 21:28
4

The correct usage is `ipython nbconvert --to html IPyNotebookTestBlogPost.ipynb` in the dev version (v2.0) – keflavich Sep 21 '13 at 23:06
5

This answer is sadly out of date. As far as I can tell, there is no longer any option corresponding to the `-f blogger-html` used in that post. The `--to html` option spits out everything including all the load/save buttons at the top of the page, and it does't appear to generate header code to put in the blogger template. If there's a way to get it to work with blogger it's not documented, and I can't figure it out. – N. Virgo May 02 '14 at 06:41

score 11 · Answer 2 · edited Oct 06 '14 at 04:57

11

One step further from the answer above. To create a PDF file,

create a tex file
```
nbconvert -f latex your_notebook.ipynb
```
convert tex to pdf :
```
pdflatex your_notebook.tex
```

edited Oct 06 '14 at 04:57

Chillar Anand

27,936
9
119
136

answered Sep 22 '12 at 13:13

Tooblippe

3,433
3
17
25

4

Is there any benefit to this approach over simply "printing" and saving as PDF? i.e., does texing improve formatting at all? – keflavich Sep 22 '12 at 20:25
Try it! It does change quite a bit. – Thriveth Oct 25 '13 at 15:09

score 8 · Answer 3 · answered Nov 24 '15 at 10:59

8

All the above answers seems outdated. Here is the most modern solution taken from the official nbconvertdocs.

$ jupyter nbconvert --to FORMAT notebook.ipynb

The default output format is html, for which the --to argument may be omitted:

$ jupyter nbconvert notebook.ipynb

answered Nov 24 '15 at 10:59

Darshan Chaudhary

2,093
3
23
42

Could you add some information about how to change style etc? Is there any way to do this? – keflavich Nov 24 '15 at 14:28

score 2 · Answer 4 · answered Nov 11 '17 at 14:26

2

Click on file > Download > html

answered Nov 11 '17 at 14:26

Gajendra D Ambi

3,832
26
30

score 1 · Answer 5 · answered Feb 09 '21 at 22:48

1

You generate the html from cmd, with your Jupyter Notebook open:

As https://stackoverflow.com/a/47773252/15117772 answered a similar question:

Also pass the --execute flag to generate the output cells

jupyter nbconvert --execute --to html notebook.ipynb

jupyter nbconvert --execute --to pdf notebook.ipynb

answered Feb 09 '21 at 22:48

Enrique Gasch

11
1

This is the latest and most up to date answer. Thanks. – Nico Bako Jan 10 '22 at 02:05

How to export an IPython notebook to HTML for a blog post?

5 Answers5

Linked