PHP: nbconvert – A wordpress plugin for Jupyter notebooks


I decided to have a little fiddle around with WordPress by making some custom PHP and CSS for the first time. The outcome is a neat little shortcode plugin for WordPress that uses Jupyter Nbviewer to create your ipynb and add it to your blog. My next step is to get this onto the WordPress Plugins so that its properly documented, versioned and available for use by the WordPress community.

Shortcode’s +/-’s

+ Very easy to use
+ Your code can be version controlled and updated without having to log into your blog and edit the raw HTML
+ Other people can work on the code, for example contributors to your GitHub page
+ Very easy to create a easy to navigate Documentation page by using WordPress and nbconvert
+ No iframes! Which many people have suggested…

– Other people can change the notebooks (It’s a blessing and a curse!)
– Dependant on nbviewer’s servers (However if you wish the code is open source so you can host your own server!)
– Could potentially be slower to render as each time a user requests your page it will have to send requests to nbviewer.
– CSS that is included in the Notebook can overwrite the blog pages CSS (try using this URL

How to use the shortcode

Step 1: Add my custom CSS (view by clicking on the button below) into Appearance -> Customize -> Additonal CSS

Step 2: In the the WordPress post editor simply enter the shortcode with the url to where the ipynb file is hosted. For example see Example 1 where we render a notebook that is stored on Folium’s GitHub page.

Example 1

[nbconvert url=""]

In [1]:
import os
import folium

In [2]:
import pandas as pd

url = ''
state_geo = f'{url}/us-states.json'
state_unemployment = f'{url}/US_Unemployment_Oct2012.csv'

state_data = pd.read_csv(state_unemployment)

m = folium.Map(
    location=[48, -102],
    tiles='Stamen Toner'

    columns=['State', 'Unemployment'],
    legend_name='Unemployment Rate (%)'

popup = 'Must be on top of the choropleth'

    location=[48, -102],
).add_to(m)'results', 'CheckZorder.html'))


Example 2

Heres another example, the shortcode in this case being:
[nbconvert url=""]

In [1]:
import os
import folium

In [2]:
from folium.plugins import Draw

m = folium.Map()

draw = Draw()

draw.add_to(m)'results', 'Draw0.html'))

In [3]:
m = folium.Map(location=[-27.23, -48.36], zoom_start=12)

draw = Draw(export=True)

draw.add_to(m)'results', 'Draw1.html'))



  1. Kevin McNeill February 10, 2018 at 4:13 pm

    First let me say, this is a great post. I followed the directions, but currently, WordPress simply displays the:
    [nbconvert url=””]

    1. Andrew Challis February 13, 2018 at 8:03 am

      Hi Kevin,

      I haven’t added this into the plugin store yet! I’ll get around to it soon, there’s just a few hoops you have to go through to get a plugin on the store…

      Once it is on the store you can install it then the short code will work 🙂

  2. Nils March 6, 2018 at 2:08 pm

    Hi Andy,

    this looks really nice! We’d love to use it here: Finally an easy way to integrate interactive notebooks.

    How’s the jumping going?;) Still planning on rolling this out?

    1. Nils March 6, 2018 at 2:10 pm

      Btw, I’m not that terrible at formatting posts, there’s a link hidden.

      1. Andrew Challis March 6, 2018 at 2:16 pm

        Hi Nils,

        I need to update my CSS it seems! 🙂 [it may be updated by the time you see this]

        I’ve not actually made a blog on how to get up and running with it yet, but it’s all on github (see below)

        1. Nils March 6, 2018 at 2:31 pm

          Right, I stalked you a bit after I posted, so I found it:) I’ll give it a shot sometime and let you know! You’re on Twitter? Very useful for marketing your side projects!

          Very nice homepage, mate!

          1. Andrew Challis March 6, 2018 at 3:23 pm

            Thanks! Feel free to send a PR if you have any changes you think would be neat.

    1. Andy Challis March 28, 2018 at 2:23 pm

      Awesome! Glad to see its come in useful 🙂

    1. Andrew Challis July 28, 2018 at 6:53 pm

      Hi Pawel, could you please raise this as an issue on GitHub, then if anyone else fancies investigating it they could submit a pull request. I’ll try to get round to fixing it soon

    2. Andrew Challis July 28, 2018 at 6:59 pm

      Hi again Pawel, just had a quick peak at your notebook and it looks like it’s using relative links to your images not absolute paths to where they are stored try changing the path to where they are stored on the web (I assume github)

  3. Raymond May 13, 2019 at 10:03 am

    Thank you very very much for this, it is just awesome

Leave a Reply to Kevin McNeill Cancel reply

Your email address will not be published. Required fields are marked *