1c:{"title":"Notebooks 2.0 user guide","cells":[{"id":0,"value":"# Notebooks 2.0 user guide\n\nNotebooks are the heart of Observable. To create a notebook, click ${icon(\"new-notebook\")} in the upper right. A notebook is a list of _cells_ of text or code. Begin typing Markdown in the initial cell, or click ${icon(\"plus\")} to insert a new cell.","pinned":false,"hidden":false,"mode":"md"},{"id":38,"value":"FileAttachment(\"Interface guide.png\").image()","pinned":false,"hidden":false,"mode":"ts"},{"id":49,"value":"The **workspace menu** lets you go to your current workspace, another workspace, or the public workspace. If you’re creating a new notebook and haven’t edited it yet, the workspace menu lets you change where it’ll be created.","pinned":false,"hidden":false,"mode":"md"},{"id":50,"value":"The **notebook header** tells you the access level, last edited date, notebook authors, and fork parent. On the right, you can star or fork the notebook, or see others who have.","pinned":false,"hidden":false,"mode":"md"},{"id":45,"value":"The **sidebar** has, at the top, toggles for several panels of additional controls:\n\n- ${icon(\"dataflow\")} **Dataflow** is coming soon.\n- ${icon(\"files\")} **Files** lets you upload, replace, rename, and delete files.\n- ${icon(\"dependencies\")} **Dependencies** lets you pick the version of the standard library: 2018 (deprecated) or 2026.\n- ${icon(\"comments\")} **Comments** lets you see comments others have left on the notebook. You cannot yet post new comments.\n- ${icon(\"version-history\")} **Version history** is coming soon. The new editor saves versions but does not yet let you browse them.\n- ${icon(\"settings\")} **Settings** shows if you have permission to edit the notebook. It lets you publish the notebook, delete it, set the access level, or set the slug.\n\n","pinned":false,"hidden":false,"mode":"md"},{"id":54,"value":"And, at the bottom:\n\n- ${icon(\"ai\")} **AI** ${buttons(\"/\")} toggles the Observable agent panel.\n- ${icon(\"pencil\")} **Enable tinkering** shows when you don’t have permission to edit.\n- ${icon(\"pencil\")} **Enable editing** shows when you can edit but are not yet an author.\n- ${icon(\"spinner\")} **Saving changes** shows when you commit a cell.\n- ${icon(\"error\")} **Warning** shows if saving failed.","pinned":false,"hidden":false,"mode":"md"},{"id":52,"value":"Additional commands appear only if editing the notebook is enabled, either because you are an author or because you have ${icon(\"pencil\")} enabled editing manually.\n\nThe **cell inserter** ${buttons(\"Cmd-Enter\")} adds a new cell in the given spot. New cells are TypeScript by default. You can cycle cell modes by pressing ${buttons(\"Down\")}.","pinned":false,"hidden":false,"mode":"md"},{"id":51,"value":"The **cell toolbar** shows commands for modifying the currently selected cells. (To enter selection mode and use these keyboard shortcuts, press ${buttons(\"x\")} with no cell focused, or ${buttons(\"Escape\")} with a cell focused.)\n\n- **Run** ${buttons(\"Shift-Enter\")} commits and runs the cell.\n- **Export** ${buttons(\"e\")} lets you export a PNG or SVG of the output of the cell.\n- **Pin** ${buttons(\".\")} toggles the whether the code is shown.\n- **Move up** ${buttons(\"Alt-Up\")} moves the cell up.\n- **Move down** ${buttons(\"Alt-Down\")} moves the cell down.\n- **Duplicate** ${buttons(\"Alt-Shift-Down\")} creates a copy of the cell below it.\n- **Delete** ${buttons(\"d\")} removes the cell.\n- **Select** ${buttons(\"x\")} toggles whether the cell is selected.\n- **Clear selection** ${buttons(\"Escape\")} removes any focus or selection.","pinned":false,"hidden":false,"mode":"md"},{"id":53,"value":"The **cell menu** can be opened by clicking the cell mode tag in the upper right of an editor. It lets you switch modes, toggle whether the cell’s code is pinned open, and toggle whether the cell’s output is hidden.","pinned":false,"hidden":false,"mode":"md"},{"id":37,"value":"$1e","pinned":false,"hidden":false,"mode":"md"},{"id":20,"value":"## AI agent\n\nThe AI agent can help you understand notebooks you’re viewing, help you edit and fix bugs, or create whole notebooks from scratch.\n\nClick ${icon(\"ai\")} in the bottom right to toggle the AI panel. You can also press ${buttons(\"/\")} to open it and ${buttons(\"Escape\")} to close it. Type a prompt and click ${icon(\"send\")} or press ${buttons(\"Enter\")}. Stop the agent by clicking the spinning ${icon(\"thinking\")}.\n\nFor every message you send, the agent sees the context of the contents of the notebook. At its discretion, it can inspect live runtime values, too. It can add, edit, move, and delete cells.\n\n

\n ${await FileAttachment(\"Agent.png\").image({width: 320})}\n

\n\nBefore it runs any code, it waits for your permission. You can allow ${buttons(\"Cmd-Y\")}, deny ${buttons(\"Cmd-Z\")}, or allow all requests from then on ${buttons(\"Shift-Cmd-Y\")}.","pinned":false,"hidden":false,"mode":"md"},{"id":30,"value":"## Files\n\nTo upload a file, click ${icon(\"files\")} **Show files** in the sidebar and then ${icon(\"upload\")} **Add file**. Once a file is uploaded, hover over it and click ${icon(\"dots\")} to replace, rename, delete, or copy the usage code to paste into a cell.\n\nUse a file in a notebook with the `FileAttachment` function. Different file types offer different methods, each of which returns a promise. For example:\n\n```ts\nFileAttachment(\"data.csv\").csv({typed: true})\n```\n\n```ts\nFileAttachment(\"data.json\").json()\n```\n\n```ts\nFileAttachment(\"data.xlsx\").xlsx()\n```\n\n```ts\nFileAttachment(\"city.shp\").arrayBuffer()\n```\n\n```ts\nFileAttachment(\"notes.md\").text()\n```\n\n```ts\nFileAttachment(\"image.jpg\").image({width: 100})\n```\n\n```html\n

\n```","pinned":false,"hidden":false,"mode":"md"},{"id":59,"value":"$1f","pinned":false,"hidden":false,"mode":"md"},{"id":57,"value":"## Authors\n\nWhen you edit a notebook, you are added to its authors. In the workspace view, notebook listings show the first author; looking at a notebook, the header shows all authors. Public notebooks you’ve authored appear on your public profile.\n\nWhen you open a notebook which you have permission to edit but haven’t edited, it will begin in read-only mode until you ${icon(\"pencil\")} enable editing in the bottom right.","pinned":false,"hidden":false,"mode":"md"},{"id":60,"value":"## Support\n\nFor help building notebooks and using the product, please post in the [forum](https://talk.observablehq.com/c/help/6), where both community members and Observable staff would be happy to chat.\n\nFor customer support or inquiries about enterprise use, please contact support@observablehq.com.\n\nNotebooks 2.0 is an early beta. We welcome all feedback and would appreciate any bug reports. We are currently working on rebuilding improved versions of features that existed in notebooks 1.0, including private notebook imports, database connectors, commenting, and the minimap, as well as new features we are excited to discuss soon.","pinned":false,"hidden":false,"mode":"md"},{"id":61,"value":"---\n## Appendix","pinned":false,"hidden":false,"mode":"md"},{"id":39,"value":"import {keys, buttons} from \"observable:@observablehq/keys\"\nimport {icon} from \"observable:@observablehq/icons\"","pinned":false,"hidden":true,"mode":"ts"}],"files":"$W20","stdlib":"2"}