Notebooks
Use notebooks when your thought process benefits from mixing prose, code, and output in one place.
Applies to: 0.1.0-beta.1Last updated: February 2026
What You Can Do
- Create notebook documents with markdown and code cells.
- Run code and inspect outputs inline.
- Use AI prompts to improve explanations or iterate code quickly.
Notebook Workflow
- Create a new notebook from the sidebar.
- Add a markdown cell to explain objective and assumptions.
- Add code cells for experiments and run them incrementally.
- Ask AI to summarize what changed between attempts.
- Export or back up once the notebook captures stable results.
When to Use Notes vs Notebooks
Use regular notes for narrative thinking and planning. Use notebooks when reproducible code output is part of the final artifact.
Screenshot Checklist
Save all screenshots under /img/docs/canto/.
| Filename | Capture Location | Place in Page |
|---|---|---|
| canto-notebooks-code-cell-run-output.png | Notebook with code cell and output rendered | Notebooks, "Notebook Workflow" section |
Documentation Screenshots
Images render automatically when files exist in /img/docs/canto/. Missing files show placeholders so publishing is never blocked.
Capture: Notebook with code cell and output rendered
Placement: Notebooks, "Notebook Workflow" section