This extension is currently in preview.

Polyglot Notebooks

With the Polyglot Notebooks extension, you can use multiple languages in the same notebook and share variables between them. No more installing different Jupyter kernels, using wrapper libraries, or different tools to get the best language server support for the language of your choice. Always use the best language for the job and seamlessly transition between different states of your workflow, all within one notebook.

Languages Supported

• C#
• F#
• PowerShell
• JavaScript
• SQL
• KQL (Kusto Query Language)
• HTML*
• Mermaid*

*Variable sharing not available

Features

• Connect to and query from Microsoft SQL Server databases and Kusto clusters
• Run and execute code for all featured languages
• Language server support such as completions, syntax highlighting, and signature help for each language
• Variable sharing between languages
• Variable Explorer to check value and state of variables
• Create detailed diagrams and visualizations using Mermaid
• Integration with your favorite VS Code extensions such as VIM and GitLens
• Notebook-friendly diffing tool that makes it easy to visually compare inputs, outputs, and metadata
• Quick navigation via Table of Contents (Outline)
• Customizable notebook layout

Getting Started

1. Install the latest Visual Studio Code.

2. Install the latest .NET 6 SDK.

3. Install the Polyglot Notebooks extension from the marketplace.

Creating Notebooks

To create a new polyglot notebook, open the Command Palette(Ctrl+Shift+P) on Windows or (Cmd+Shift+P) on MacOS, and select Polyglot Notebook: Create new blank notebook. You can also create a new notebook with Ctrl+Shift+Alt+N key combination on Windows.

Running Code

Execute code by selecting the subkernel in the bottom right of each cell, or use language magic commands to mix languages in one cell regardless of the chosen subkernel.

Variable Sharing + Variable Explorer

Share variables from subkernel to subkernel via the #!share magic command that is easily generated from the Variable Explorer. Use the Variable Explorer to manage the state and value of your variables.

Examples

• Connect to a SQL database, share the tabular result to JavaScript, and create your own custom visualizations.

• Create powerful advanced diagrams and visualizations such as Class diagrams using code and text by leveraging Mermaid.

Why do I need the .NET SDK?

Polyglot Notebooks is powered by .NET Interactive. .NET Interactive is an engine that can run multiple languages and share variables between them and is built using .NET technology. At this time, it is required for the extension to function.

Filing Issues + Feature Requests

You can file issues or feature requests on the .NET Interactive GitHub repository.

Telemetry

The Polyglot Notebooks extension for VS Code uses the dotnet-interactive tool which collects usage and sends telemetry to Microsoft to help us improve our products and services.

Telemetry is collected when .NET Interactive is started. Once .NET Interactive is running, we collect hashed versions of packages imported into the notebook and the languages used to run individual cells. We do not collect any additional code or clear text from cells. The telemetry is anonymous and reports only the values for a specific subset of the verbs in the .NET Interactive CLI. Those verbs are:

• dotnet interactive jupyter
• dotnet interactive jupyter install
• dotnet interactive http
• dotnet interactive stdio

Read our privacy statement to learn more. See here to learn more about telemetry in Polyglot Notebooks.

License

Copyright © .NET Foundation, and contributors.

The source code to this extension is available on https://github.com/dotnet/interactive and licensed under the MIT license.