Data Science and ML tools
Jupyter notebook support
Create and edit Jupyter notebooks

Create and edit Jupyter notebooks

Last modified: 10 February 2025

Available only in PyCharm Professional: download to try or compare editions

Create a Jupyter project

note
Make sure that you have conda installed.

Go to File | New Project.
Select a Jupyter project template.
Select the project location. Click in the Location field and specify the directory for your project. The project name will be automatically derived from the folder name in the specified path.
Select Create Git repository to put the project under Git version control.
Select Create a simple Jupyter notebook if you want PyCharm to add the sample.ipynb file to your project. This file contains a sample Jupyter Notebook and can help you get acquainted with the notebook editor UI and other features.
Click Create.

Create and open Jupyter notebooks

To open an existing .ipynb file, follow the same steps as for the files of the other types. If needed, you can create a notebook file.

Create a notebook file

Do one of the following:
- Right-click the target directory in the Project tool window and select New from the context menu.
- Press AltInsert
Select Jupyter Notebook.
In the dialog that opens, type a filename.

A notebook file has the *.ipynb extension and is marked with the corresponding icon .

Convert a Python file to a Jupyter notebook

Right-click the file in the Project tool window.
Select Convert to Jupyter Notebook from the context menu.

Convert a Jupyter notebook to a Python file

Right-click the file in the Project tool window.
Select Convert to Python File from the context menu.

Export Jupyter notebooks

You can export Jupyter notebooks to various formats:

Right-click the Jupyter notebook file in the Project tool window.
Select Export Notebook As and then select the format from the list.

Edit Jupyter notebooks

You can apply various editing actions to one cell or to the entire notebook. Press the Ctrl0A once to select a cell at the caret and press Ctrl0A twice to select all cells in the notebook.

note
PyCharm updates the source code and the preview of the notebook if it has been changed externally.

The editor for Jupyter notebooks has two modes: the edit mode and the command mode. Depending on the mode, you can either edit code in notebook cells or use keyboard shortcuts to perform specific actions with cells.

Edit mode

To toggle the edit mode, press Enter or click any cell.
When a cell is in the edit mode, it has a highlighted line with a caret inside the cell.
When in the edit mode, you can navigate through all cells line-by-line using 0↑ and 0↓ keys.

Command mode

To toggle the command mode, press Esc or click the gutter.
When in the command mode, you can navigate the notebook cell by cell using 0↑ and 0↓ keys, as well as use keyboard shortcuts to select, copy, paste, and delete cells.

Edit cells

A newly created notebook contains one code cell. You can change its type with the cell type selector in the notebook toolbar:
To edit a code cell, just click it.
To edit a Markdown cell, double-click it or press Enter and start typing. To preview the output, press ShiftEnter.

Work with notebook cells

Add cells

To add a code cell above the selected cell, do one of the following:
- In the edit mode, press AltShift0A.
- In the command mode, press 0A.
To add a code cell below the selected cell, do one of the following:
- In the edit mode, press AltShift0B.
- In the command mode, press 0B.
- Select Code Cell Below from the notebook toolbar.
Use the popup between cells to add code, Markdown or AI cells to your notebook:

Select cells

To select a cell, click the gutter next to the cell.
To select several cells:
- Click the gutter next to cells while holding Shift for a series of consecutive cells, or Ctrl for non-consecutive cells.
- In the command mode, hold Shift and press the 0↑ and 0↓ keys.

You can execute, copy, merge, expand, comment and delete the selected cells.

Copy and paste cells

To copy a cell in the command mode, press Ctrl0C, 0C, or click on the notebook toolbar.
To paste the copied cell below, press Ctrl0V, 0V, or click .
To paste it above the current cell, press Shift with Ctrl0V/Shift0V.
You can also select the required action from the cell's context menu.

Split and merge cells

To merge a current cell with the cell below, right-click the cell and select the Merge Cell Below command from the context menu.
Similarly, you can merge a cell above the selected cell with the corresponding command.
To merge several cells, select them, and then choose Cell | Merge Selected Cells from the main menu.
Alternatively, you can use Find Action to run the Merge Selected Cells command.
To split a cell into two cells, place the caret in the line to break at, then right-click, and select the Split Cell from the context menu.

Expand and collapse cells

Click the border in the gutter to expand or collapse a notebook cell.
Expanded notebook cell
Collapsed notebook cell
Click the chevron next to the Markdown cell heading to collapse or expand code cells below. The number of collapsed cells will be shown under the heading.
Expanded notebook cells
Collapsed notebook cells

Comment out cells

To comment out an active cell, switch to the command mode and press Ctrl0/.
To comment out multiple cells, select them in the command mode, then press Ctrl0/.

Delete cells

Click Delete Cell on the notebook toolbar.
Right-click the cell and select Delete Cell from the context menu.

Add cell tag

You can assign and view tags for each cell right in the notebook editor:

Right-click the cell.
Select Add Cell Tag from the context menu.
Enter the tag and click Confirm.

To remove the tag, right-click it and select Remove Tag.

Use coding assistance

You can edit code cells with the help of Python code insights, such as syntax highlighting and code completion.

PyCharm enables code completion for the names of classes, functions, and variables. Start typing the name of the code construct, and the suggestion list appears.
Methods and functions
Class variables
File paths
Packages
DataFrame columns
note
The auto-completion of DataFrame columns names is available in runtime. PyCharm will suggest the names for columns only if the cell where the DataFrame is created has already run in the current kernel session.
Intention actions and quick fixes. You can add the missing imports by using the intention actions.
Note that you can add an import statement to the current cell or to the first cell of the notebook.

Thanks for your feedback!

Was this page helpful?

Create and edit Jupyter notebooks

See also

Language and Framework-Specific Guidelines

Create and edit Jupyter notebooks﻿

Create a Jupyter project﻿

note

Create and open Jupyter notebooks﻿

Create a notebook file﻿

Convert a Python file to a Jupyter notebook﻿

Convert a Jupyter notebook to a Python file﻿

Export Jupyter notebooks﻿

Edit Jupyter notebooks﻿

note

Edit mode﻿

Command mode﻿

Edit cells﻿

Work with notebook cells﻿

Add cells﻿

Select cells﻿

Copy and paste cells﻿

Split and merge cells﻿

Expand and collapse cells﻿

Comment out cells﻿

Delete cells﻿

Add cell tag﻿

Use coding assistance﻿

note

See also

Language and Framework-Specific Guidelines

Create and edit Jupyter notebooks

Create a Jupyter project

Create and open Jupyter notebooks

Create a notebook file

Convert a Python file to a Jupyter notebook

Convert a Jupyter notebook to a Python file

Export Jupyter notebooks

Edit Jupyter notebooks

Edit mode

Command mode

Edit cells

Work with notebook cells

Add cells

Select cells

Copy and paste cells

Split and merge cells

Expand and collapse cells

Comment out cells

Delete cells

Add cell tag

Use coding assistance