Add a notebook

Jupyter Notebook Viewer for Confluence shows one .ipynb file that is already attached to the current page or blog post. The file has to be nbformat 4, which is the notebook format Jupyter has saved for years.

Updated 10 November 2026.

Attach the file

1. Open the page.
2. Attach the .ipynb file to that page. A link to a notebook on another website will not work.
3. Edit the page and type /Jupyter Notebook.
4. Choose the file. If the page has one notebook, that file is already selected.
5. Select Insert notebook, then publish the page.

People who can view the page see that notebook, with their own permission to the page. The app does not keep a separate copy.

On a blog post

The same steps work on a blog post. The app looks up attachments on the post you are editing.

One notebook

Each macro shows one file. To show a second notebook, attach it and insert the macro again.

Refused files

• A notebook that is not nbformat 4.
• A file larger than 2 MB. In Jupyter, clear large outputs, save, and attach the file again.
• A file that is not attached to this page. If the file is renamed, edit the macro and choose the new name.

If the macro asks you to choose a file, the steps are on the troubleshooting page.