How to create a new notebook

First, go to the Pluto main menu. Then, click the โ€œNewโ€ button. This will create a new empty notebook in the current Pluto session.

screenshot of the Pluto main menu, showing the new notebook button

Tip

You can right click the โ€œNewโ€ button, and select โ€œOpen in new tabโ€. This will open the new notebook in a new tab, and you can open more notebooks in parallel.

How to save a notebook

Notebooks are saved automatically when you run code. When you start typing new code in a cell, this code is not yet saved, but when you run the cell, the code is saved.

When there are unsaved changes in a notebook, you will see a button in the top right corner of the notebook โ€“ the โ€œSaveโ€ button. Clicking this button will run all unsaved cells in one batch, which will automatically save the notebook.

screenshot of the Save button in the top right corner of a notebook

How to preview and run a notebook

When you first open a Pluto notebook, it opens in safe preview mode. This lets you explore the notebook without running any code yet. In this view, you can:

  • Read through the code and verify you want to run it
  • Edit code, move cells around, or hide cells, all without executing anything!
  • View md"" and html"" blocks without interpolation (JS and CSS wonโ€™t run)

When youโ€™re ready to run the notebook:

  • Click the โ€œRun Notebook Codeโ€ button to start
  • The package environment will initialize
  • All cells will execute

How to shut down a notebook

โš ๏ธ Closing the browser tab doesnโ€™t stop the notebook โ€” it keeps running in the background. This means you can reopen the notebook anytime by navigating back to its URL in Plutoโ€™s main menu, and it will appear exactly as you left it without needing to rerun all the cells.

To actually shut down a notebook:

  1. Navigate to Plutoโ€™s main menu (the home page with your list of notebooks)
  2. Find the notebook you want to shut down in the list
  3. Click the button on the left side of the notebook entry

This will completely shut down the notebook and stop its Julia process, freeing up system resources. The notebook will remain in your list so you can easily reopen it later (it will need to rerun from scratch when you open it again).

screenshot of the Save button in the top right corner of a notebook

To remove a notebook from the list: If you want to clear a notebook from your main menu entirely, click the โ€œforgetโ€ button on the right side of the notebook entry. This only removes it from the list โ€” the notebook file itself remains saved on your computer.

screenshot of the Save button in the top right corner of a notebook

Tip: To stop all running notebooks at once, you can close the Pluto server by pressing Ctrl+C in the terminal or command prompt where Pluto is running.

To restart a notebook (restart kernel)

If you want to restart a notebook thatโ€™s currently running โ€” for example, to clear all variables and start fresh โ€” simply shut it down using the button and then reopen it by clicking on it in the list. This is equivalent to โ€œrestarting the kernelโ€ in other notebook environments like Jupyter.