Notebook guides
How an .ipynb file is put together, what each export keeps, how to clean a notebook before you share it, and how to read one without installing Jupyter. Written and updated by Khalid Danishyar. These pages stand on their own. The tools are optional.
- 01Updated
What an .ipynb file actually contains
A notebook is JSON: cells, saved outputs, and metadata. What is stored, what is only a recording of a past run, and what never makes it into the file.
Read guide - 02Updated
What each notebook export keeps and drops
PDF, Word, Markdown, HTML, and Python keep different parts of a notebook. A format-by-format comparison of source, outputs, images, and what cannot round-trip.
Read guide - 03Updated
How to clean a notebook before you share it
Outputs, execution counts, tokens, and printed data are part of the file. A checklist for what to strip, what to keep, and how to search before you send an .ipynb.
Read guide - 04Updated
A worked example: one sample notebook, five exports
Follow the public sample notebook through PDF, Word, Markdown, HTML, and Python. What you should see, what is missing on purpose, and how to tell a setting from a bug.
Read guide - 05Updated
How to read a notebook when Jupyter is not installed
Reading a notebook is parsing JSON and showing saved cells. It does not require a kernel. When to use a text editor, when to use a viewer, and what not to run.
Read guide
Practice on the sample notebook. It has no secrets and one saved text output.