Introducing Native Notebooks

Dealing with some small experience issues? See if your issue already exists under our "papercut" label, or create a new one here: Papercut Issues for Notebooks

Enabling the new experience

• There are two ways to enable the new experience:

1. Use VS code insiders (https://code.visualstudio.com/insiders/). It will pickup an 'insiders' version of the Jupyter Extension that automatically uses the new UI
2. Enable the 'NativeNotebookEditor' experiment in your settings.json. This is done by adding these lines below:

    "workbench.editorAssociations": {
        "*.ipynb": "jupyter-notebook"
    },
    "jupyter.experiments.optInto": [
         "__NativeNotebookEditor__"
    ],

Notebook Quick Start

• To create a new notebook open the command palette (Windows: Ctrl + Shift + P, iOS: Command + Shift + P) and select the command "Jupyter: Create New Blank Jupyter Notebook"

• Select your kernel by clicking on the kernel picker in the bottom right of the status bar or by invoking the "Notebook: Select Notebook Kernel" command.

Notebook Tour Guide

Notebook Toolbar

Cell Toolbar - Customizable via Notebook: Cell Toolbar Location setting

Kernel Picker

Language Picker

Add code and markdown cells

Cell Execution

Connect to a remote Jupyter server by clicking on the action in the bottom right of the status bar or by invoking the "Jupyter: Specify local or remote Jupyter server for connections" command.

If you would like to opt-out of Native Notebooks:

• Open the command palette (Windows: Ctrl + Shift + P, iOS: Command + Shift + P) and select "Preferences: Open Settings (JSON)"
• Add the following code to your JSON settings: "jupyter.experiments.optOutFrom": ["NativeNotebookEditor"]
• Remove the following code from your workbench.editorAssociations section in your JSON settings:

{
      "viewType": "jupyter-notebook",
      "filenamePattern": "*.ipynb"
}