Notebook

Notebook brings executable, reactive notebooks to Lapis while keeping the document format close to markdown.

Use Notebook when a note needs live computation, structured outputs, or a repeatable analysis workflow.

What You Can Build

• Notes with executable JavaScript cells.
• SQL-backed explorations with DuckDB.
• Markdown explanations mixed with computed output.
• Tables, charts, images, errors, and markdown outputs.
• Small interactive controls through notebook inputs.
• Durable analysis documents that stay inside the vault.

Cell Syntax

Notebook cells are markdown containers with an id and language. JavaScript and TypeScript-style cells can define values that later cells use:

:::cell{#answer lang="ts"}

const answer = 42; answer;

:::

SQL cells can query registered data and return table output:

:::cell{#totals lang="sql"}

SELECT category, count(*) AS rows FROM notes GROUP BY category;

:::

Supported Functionality

• Reactive cell execution with dependency tracking.
• JavaScript and TypeScript-style code cells.
• SQL cells backed by the notebook DuckDB runtime.
• Markdown cells for written explanation.
• Output rendering for text, markdown, HTML, tables, charts, images, and errors.
• Notebook inputs for interactive values.
• Persisted output and input state where the runtime supports it.

Useful For

Why It Fits Lapis

Notebook keeps computation close to the written context. Instead of splitting analysis across scripts, spreadsheets, and notes, the explanation and the result can live together.