Embed or view Jupyter/IPython notebooks in Confluence

Nar Kumar Chhantyal
Bitwelt Software
Published in
2 min readOct 14, 2019
Example notebook in Confluence with pie chart

Confluence is widely used enterprise knowledge management system. It has expensive support for importing documents written in different system as well as embedding contents written in different formats.

However, it does not have built-in support for all formats in use out there. One of them is Jupyter Notebook format.

Jupyter (previously IPython) is an interactive computing framework. It allows users to create documents that contain live executable code, data, documentation and visualization.

It’s common practice to experiment in Jupyter notebook and share with co-workers, collaborators and other users. Since Atlassian does not support Jupyter notebook format (.ipynb files), this is workflow is hindered in Confluence.

Fortunately, there is add-on Jupyter/IPython Notebook Viewer available from Atlassian Marketplace which can solve this problem.

In order to view/render your notebooks in Confluence, follow these simple steps:

  1. Install Jupyter/IPython Notebook Viewer from Marketplace.
  2. Create a page and find above add-on using macro browser.
  3. Upload your notebook file.
  4. Done, your notebook is beautifully rendered.

You can also directly embed notebooks from VCS like Bitbucket and Github or any other publicly accessible URL. For a detailed usage guide, please visit documentation here.

It still does not fully solve your problem? Send us feature request and we are happy to help :)

--

--