Deepnote extension for VS Code, Cursor, and Windsurf

A powerful extension for VS Code, Cursor, and Windsurf that brings Deepnote notebook capabilities directly into your favorite AI-native code editor. Work with slick AI notebooks featuring SQL blocks, database integrations, and reactive blocks.

Available on:

• VS Code Marketplace
• Open VSX Registry (for Cursor, Windsurf, and other VS Code compatible editors)
• GitHub Repository

The Deepnote extension provides:

• Native .deepnote file support - Open and edit Deepnote notebooks
• Block execution - Run code, SQL, and other executable blocks
• Rich outputs - Display DataFrames, plots, and visualizations
• IntelliSense - Code completion and suggestions
• Debugging - Set breakpoints and debug code blocks
• Git integration - Version control for notebooks
• Local execution - Use your own Python environment
• One-click deploy - Push notebooks to Deepnote.com to build and share data apps with cloud CPU/GPU machines

Installation

From marketplace

1. Open your editor

   • Launch VS Code, Cursor, or Windsurf

2. Open Extensions View

   • Click Extensions icon in sidebar (Ctrl/Cmd + Shift + X)
   • Or go to View → Extensions

3. Search for Deepnote

   • Type "Deepnote" in the search box
   • Find "Deepnote" by Deepnote

4. Install

   • Click "Install" button
   • Wait for installation to complete
   • Reload your editor if prompted

From command line

# Install using CLI
code --install-extension deepnote.vscode-deepnote  # VS Code
cursor --install-extension deepnote.vscode-deepnote  # Cursor
windsurf --install-extension deepnote.vscode-deepnote  # Windsurf

Verify installation

1. Open Command Palette (Ctrl/Cmd + Shift + P)
2. Type "Deepnote"
3. You should see Deepnote-related commands

Features

Native .deepnote file support

The extension automatically associates .deepnote files with the notebook interface, providing YAML syntax highlighting when viewing the raw file and a structured notebook view for editing. You can work in three different view modes: Notebook View for interactive editing and execution, Source View for raw YAML editing, or Split View to see both views side-by-side.

Viewing raw YAML:

To view the raw .deepnote file structure:

1. Right-click the .deepnote file in the File Explorer
2. Select "Open With..."
3. Choose "Text Editor"

This opens the file in VS Code's standard text editor with YAML syntax highlighting, allowing you to inspect or edit the underlying file structure directly.

Block execution

The extension supports executing Python code blocks, SQL blocks with database connections, all types of input blocks, and rendered Markdown blocks. You can run a single block by clicking the play button or pressing Shift + Enter. The extension also provides controls to clear outputs and remove all execution results.

Keyboard shortcuts:

Rich output display

The extension displays a wide variety of output types including text output from stdout and stderr, interactive DataFrame tables, plots from matplotlib, seaborn, and plotly, images in PNG, JPEG, and SVG formats, HTML content, pretty-printed JSON and dictionaries, and formatted error tracebacks.

IntelliSense and code completion

The extension provides comprehensive IntelliSense features including auto-completion for Python code, function signatures with documentation, import suggestions, variable inspection, and type hints. IntelliSense triggers automatically as you type and pause, or you can manually invoke it by pressing Ctrl/Cmd + Space.

Debugging Support

The extension includes full debugging capabilities, allowing you to set breakpoints in code blocks, step through execution, inspect variables, evaluate expressions, and view the call stack. To start debugging, click in the left margin to set a breakpoint, then click the "Debug Cell" button and use the debug controls to step through your code.

Variable explorer

The Variable Explorer lets you see all variables in the current scope, inspect their values and types, view DataFrame shapes, and expand nested structures. You can access it by clicking "Variables" in the notebook toolbar or using the Command Palette to run "Deepnote: Show Variables".

Code blocks

Learn more about code blocks in the Deepnote documentation.

Configuration

Extension settings

Access the extension settings by navigating to File → Preferences → Settings (or pressing Ctrl/Cmd + ,) and searching for "Deepnote".

Python environment

To select your Python interpreter, open the Command Palette with Ctrl/Cmd + Shift + P, type "Python: Select Interpreter", and choose your preferred Python environment from the list.

The Deepnote extension brings powerful notebook capabilities to your local development environment, combining the flexibility of Deepnote notebooks with the robust editing features of VS Code, Cursor, and Windsurf. Whether you're executing code, debugging complex logic, or viewing rich outputs, the extension provides a seamless experience that enhances your data science workflow.

Links:

• VS Code Marketplace
• Open VSX Registry
• GitHub Repository
• Documentation
• Report Issues