Verso Notebook

Interactive .NET notebooks for VS Code with C#, F#, SQL, and more.

Features

• C# and F# with IntelliSense including completions, diagnostics, hover info, and NuGet package references
• SQL database connectivity with paginated results, schema inspection, and EF Core scaffolding
• Markdown, HTML, and Mermaid cells for documentation, visualizations, and diagrams
• Variable sharing across languages so you can set a value in C# and use it in SQL or F#
• Notebook and Dashboard layouts to view cells as a linear document or arrange them in a drag-and-drop grid
• Light, Dark, and High Contrast themes that are hot-swappable at runtime (High Contrast meets WCAG 2.1 AA)
• Import Jupyter (.ipynb) and Polyglot (.dib) notebooks with automatic conversion of magic commands and cell types
• Fully extensible with a public API for adding new languages, cell types, themes, layouts, and more

Writing Code with IntelliSense

Verso's C# kernel is powered by Roslyn, giving you the latest language features, persistent state across cells, real-time error checking, and code completions as you type. The F# kernel offers the same experience powered by FSharp.Compiler.Service.

Notebook and Dashboard Layouts

Every notebook can be viewed in two ways. Notebook layout presents cells in a familiar top-to-bottom flow. Dashboard layout lets you drag and resize cells on a 12-column grid to build interactive dashboards. Both layouts are saved in the .verso file and you can switch between them at any time.

SQL Database Support

Connect to any ADO.NET-compatible database (SQL Server, PostgreSQL, MySQL, SQLite) and run queries directly in your notebook. Results render as paginated tables with column type tooltips. You can share variables between SQL and C# cells, inspect schema, and scaffold EF Core DbContext classes at runtime.

Importing Existing Notebooks

Already have notebooks in Jupyter or Polyglot format? Open any .ipynb or .dib file and Verso converts it automatically. SQL connection patterns, language directives, and magic commands are mapped to their native Verso equivalents during import.

Getting Started

1. Install the .NET 8 SDK
2. Install this extension from the VS Code Marketplace
3. Open an existing .verso file or create a new file with a .verso extension to start working

To import an existing notebook, use File > Open on any .ipynb or .dib file.

Supported Languages

Extensibility

Verso is built on a fully extensible architecture. Every built-in feature, from the C# kernel to the Dark theme, is implemented using the same public interfaces available to extension authors. You can create new language kernels, cell types, themes, layouts, toolbar actions, and data formatters.

See the Verso repository for documentation, extension samples, and the dotnet new verso-extension template.

Support

Found a bug or have a feature request? Open an issue on GitHub.

License

MIT

Verso is a Datafication project.