Skip to main content
Malloy notebooks (.malloynb files) blend markdown text, Malloy queries, and visualizations into interactive documents. Unlike traditional notebooks, they’re built on your semantic layer, ensuring consistent, governed definitions across all analysis. Create and edit notebooks in VS Code (assuming you have a Malloy model first), then publish them with your package. Published notebooks become read-only for consumers. Use notebooks for data storytelling with live queries, documenting standard analyses, building simple KPI dashboards, or adding a README.malloynb to provide an interactive package overview.

​
Creating Notebooks

​
In VS Code

  1. Create a file with .malloynb extension
  2. Add markdown blocks for descriptions or headings
  3. Add code blocks for Malloy queries
  4. Run the notebook cell-by-cell or click “Run All” to see results for the entire notebook

​
Basic Example

Here is a screenshot of a markdown cell (Business Overview…) and code cell (run: order_items...) in a malloynb notebook in VS Code. Malloy Notebook Example

​
README.malloynb

Create a README.malloynb in your package root for special functionality:
  • Automatically renders on the package landing page
  • Provides package overview with live examples
  • Serves as onboarding guide for new users

​
Next Steps

Embedded Data

Include CSV and Parquet files in packages

Publishing Models

Learn how to publish packages with notebooks