How to Share a Jupyter Notebook as a Link

You ran the analysis, the charts came out right, and now someone who does not use Jupyter needs to see it. The usual answers both have a catch. nbviewer renders a notebook beautifully, but it has to be public on GitHub or a Gist first. nbconvert gives you a self-contained HTML file, which is a file, so you are back to sending an attachment. Here is how to share a Jupyter notebook as a link instead.

Export the notebook to one HTML file

From the command line:

jupyter nbconvert --to html --embed-images analysis.ipynb

In JupyterLab, the same thing lives under File, Save and Export Notebook As, HTML.

--embed-images matters. Without it your plots can end up as references to files that never travel with the document, and the reader gets a page full of broken images. With it you get one analysis.html that carries its own charts, styling and output.

Share it in three steps

1. Export the notebook to a single HTML file.
2. Open ShareMyPage, create a new page, and upload or paste that file.
3. Choose who can see it, then send the link.

The page renders at a clean URL, runs in a sandboxed frame, and keeps working when you re-run the analysis and replace it. The link does not change, so nobody has to be sent a second one.

Keeping it private is the whole point

This is where the usual route breaks down. nbviewer only renders notebooks that are already public, which rules it out for anything with customer numbers, salaries or unpublished results in it.

• Public for a write-up you want indexed and quoted.
• Password protected when it goes to a client or a committee.
• Workspace when it should stay with colleagues, which is most internal analysis.

Interactive output keeps working too. A Plotly or Altair chart embeds its own JavaScript in the exported file, and the page runs that in a sandbox, so hover and zoom behave the way they did in your notebook.

Why a link beats the notebook file

A .ipynb asks the reader to have Jupyter. An .html attachment asks them to download something before they can look at it, and it opens badly on a phone. A link opens anywhere, previews properly when you paste it into Slack, and always shows the current run rather than whichever copy somebody saved in March.

If you publish analysis regularly, see how to share a Markdown file as a web page for notes and docs, and password-protecting a shared page for anything client facing.

Ready to send your next analysis as a link? Create a page on ShareMyPage and upload the exported HTML.