Editor Basics
A SpiceBook notebook is a vertical sequence of cells. Each cell has a type that determines how it behaves and renders.
Cell Types
Section titled “Cell Types”| Type | Purpose | Editor |
|---|---|---|
| Markdown | Documentation, headings, LaTeX-style math | Rich text with live preview |
| SPICE | Circuit netlists for simulation | Code editor with SPICE syntax highlighting |
| Python | Computation and scripting | Code editor (execution planned) |
| Schematic | Auto-generated circuit diagrams | Read-only SVG display |
Markdown cells render immediately as you type. SPICE cells require you to click Run to execute the netlist and see simulation results.
Toolbar
Section titled “Toolbar”The notebook toolbar sits at the top of the editor and provides:
- Run All — executes every SPICE cell in order, top to bottom
- Engine selector — switch between ngspice and LTspice for the entire notebook
- Embed — opens a popover with a ready-to-copy iframe snippet for sharing
- Tags — add searchable tags to organize notebooks on the homepage
Each individual SPICE cell also has its own run and schematic buttons in the cell toolbar.
Adding and Reordering Cells
Section titled “Adding and Reordering Cells”Click + Add Cell between any two cells to insert a new one. The dropdown lets you choose the cell type.
Cells can be reordered by dragging, or programmatically via the reorder API endpoint.
To delete a cell, use the cell menu (three dots) and select Delete.
Code Editor
Section titled “Code Editor”SPICE cells use a code editor with:
- Syntax highlighting for SPICE netlist keywords (
.tran,.ac,.op, etc.) - Line numbers for referencing specific netlist lines
- Auto-indentation following SPICE conventions
Notebook Metadata
Section titled “Notebook Metadata”Every notebook tracks:
- Title — displayed in the gallery and browser tab
- Engine —
ngspiceorltspice, applies to all SPICE cells - Tags — free-form labels for filtering in the notebook gallery
- Created / Modified — ISO-8601 timestamps, set automatically