Desmos Notebook User Guide

Welcome to Desmos Notebook (Beta*)

Desmos Notebook combines text, expressions, sliders, and graphs in a single, dynamic environment, with the power of the Desmos graphing tools built in.

If you have questions that aren’t answered here, please visit our Help Center or send us an email at support@desmos.com.

*Desmos Notebook is currently in beta. This means that it will have bugs and missing features. We will be adding new capabilities in the coming weeks and months, and these updates might impact notebooks that you create.

 

Items and Key Features

Quick TipQuick Tip: For helpful resources and Notebook keyboard shortcuts, click Help Help or type Ctrl+Alt+H (Windows) or Ctrl+Cmd+H (Mac).

When you open Desmos Notebook, you’ll arrive at the editor of a blank notebook. From here, you can write text and expressions, and you can open the Item menu to add items to your notebook.

Notebook with the Item menu, text formatting bar, variable tokens, and graph expressions shown. Screenshot.

Start Typing

The main body of a notebook is a blank page. You can start typing straight away. The text formatting bar provides controls for paragraph styles Paragraph Styles, alignment Alignment, bold Bold, italics Italics, inserting inline math Inline Math, and columns Columns. This bar also has controls to undo Undo and redo Redo actions and displays Mute Mute and Random Random toggles when applicable.

Toolbar icons showing: Paragraph styles, Alignment, Bold, Italics, Inline math, Columns, Undo, Redo options. Text reading “The area of a circle is πr²” with bold, italics, and inline math. Screenshot.

To change paragraph styles with keyboard shortcuts, type:

  • Paragraph: Ctrl+Alt+0 (Windows) or Ctrl+Option+0 (Mac)
  • Title: Ctrl+Shift+1 (Windows) or Ctrl+Option+1 (Mac)
  • Heading: Ctrl+Shift+2 (Windows) or Ctrl+Option+2 (Mac)
  • Subheading: Ctrl+Shift+3 (Windows) or Ctrl+Option+3 (Mac)

When typing inline math, enter keyboard shortcuts such as Forward Slash (/) for a fraction, Asterisk (*) for multiplication, Caret (^) for an exponent, or other common symbols supported in our graphing tools. You can also enter matrix to create a \(2×2\) matrix or use the syntax \(\mathbf{\#ab}\), where \(a\) is the number of rows, and \(b\) is the number of columns.

Use the Keypad

When you are focused in a notebook expression line or inline math, you have the option to open a function keypad. To open the on-screen keypad, click Show Keypad Show Keypad. From there, you can select letters, numbers, symbols, and functions to add to your expression or text. You can use your own keyboard to type everything on the keypad as well.

Press Ctrl+Forward Slash (/) (Windows) or Cmd+Forward Slash (/) (Mac) to open the list of keyboard shortcuts. Or, click Help Help and then Keyboard Shortcuts.

Item Menu

Open the Item menu to insert expressions, graphs, special characters backslash (\) and backtick (`) (which you can use for typing some forms of advanced math expressions), and references to variables.

You can press the Back Slash (\) key or use the keyboard shortcut Ctrl+Alt+O (Windows) or Ctrl+Cmd+O (Mac) to open the menu.

Item menu with expression, graph, variable, and special character options shown. Along with Notebook and Graph variables. Screenshot.

Add Expressions

Open the Item menu and select Expression to add an expression to your notebook. Or, use the keyboard shortcut Ctrl+Enter (Windows) or Cmd+Return (Mac).

You can then perform calculations or define variables or functions, which you can reference in other expression lines or within graphs. When applicable, the evaluation will appear in the expression line.

Expression lines showing a calculation, a function, a function value, and matrix multiplication. Screenshot.

Add Graphs

You can add Graphing, Geometry, and 3D Calculator graphs to your notebook in the editor. To do so, open the Item menu and select the desired type of graph. Or, use the keyboard shortcuts:

  • 2D Graph: Ctrl+Alt+2 (Windows) or Ctrl+Cmd+2 (Mac)
  • 3D Graph: Ctrl+Alt+3 (Windows) or Ctrl+Cmd+3 (Mac)
  • Geometry: Ctrl+Alt+G (Windows) or Ctrl+Cmd+G (Mac)
Notebook graph with its expression list open. Screenshot.

When you select a graph, you can edit its expression list in the Notebook sidebar to plot points, graph equations, evaluate expressions, and more. You can click and drag to pan your graph or use Ctrl+Scroll (Windows) or Cmd+Scroll (Mac) to zoom.

You can also click Graph Settings Graph Settings to adjust that graph’s settings.

Click View Fullscreen View Fullscreen to view your graph in more detail. When you have finished making your adjustments, click Apply Changes to update how the graph appears in your notebook.

Import Graphs

You can also import a saved graph from the Graphing, Geometry, or 3D Calculator. First, paste the URL of the intended graph into the Item menu. Then, click the thumbnail that appears.

When you paste a graph into a notebook, you are importing that graph state. You are not creating a live connection to the original graph. This means that any changes you make to the graph in the notebook will not impact the graph in the calculator, and any changes you make to the graph in its calculator will not impact the notebook.

Graph URL pasted into the Item menu, showing the graph thumbnail. Screenshot.

Organize Your Notebook

You can rearrange the order of items in the notebook by dragging them to the desired placement on the page.

Columns menu with Insert Column Left and Insert Column Right. Screenshot.

You can also organize your notebook by placing text, expressions, sliders, and graphs into columns.

Select Columns to add a column to the right or left of your current cursor selection. Each column takes up half the width of the notebook, and the height will adjust to the included content. You can then drag items within the column, too.

Paragraph styles menu with Title, Heading, Subheading, and Paragraph shown in a dropdown. Screenshot.

Select Paragraph Styles for options you can use to separate your notebooks into sections.

Table of contents listing notebook headings shown. Screenshot.

Titles, headings, and subheadings provide visual separation with varying font sizes. They also appear in a table of contents within your notebook. This linked table appears in the sidebar of the editor. Or, click the Table of Contents dropdown Table of Contents after clicking Preview or when viewing a shared notebook.

Click any heading or subheading from the table of contents to go to that section.

 

Notebook Variables and Sliders

Define Notebook Variables

The Notebook Variables menu displays all the variables defined in the notebook along with their current values. If you define a variable in an expression line, it immediately appears in the menu. You can then reference it throughout the notebook in graphs, expressions, and inline math.

Click Variable Options Variable Options to change the color associated with the variable or immediately go to the expression where that variable is defined.

Notebook Variables menu with Variable Options shown. Screenshot.

Connect Graph Variables to Your Notebook

Just like in the other Desmos graphing tools, you can define variables in expression lines within the graphs that you add to your notebook. These variables do not appear as notebook variables automatically, which means that you cannot reference them throughout the rest of the notebook.

To connect a variable to your notebook, open the graph with the variable and locate it within the expression list. Then, click Connect to Notebook Connect to Notebook. After you’ve linked a variable, it will appear under Notebook Variables.

Connect to Notebook button in a graph’s expression list. Screenshot.

Add and Adjust Sliders

Sliders allow you to interact with the variables connected to your notebook. If you adjust a slider, any graph or expression that uses that variable will update instantly.

To add a slider for any variable, click Variable Options and then Add Slider. If you define a variable within an expression in the notebook, you can also add a slider by clicking Add Slider within the expression line.

Variable Options with color choices, Add Slider, and Go to Definition shown in a dropdown menu. Screenshot.

Click Slider Options Slider Options to access settings to control any slider’s appearance and behavior. You can add a label (which defaults to the name of the variable), change the bounds or step size, and toggle the display of the slider value.

The upper and lower bounds and step size determine the values that your variable can take. If you define a variable in a graph and then connect it to your notebook, you can change the slider settings in that graph or in an expression line in the notebook.

Slider Options for variable a. Screenshot.

Variable Tokens

Tokens represent variables or their values in text and in calculations within expressions and graphs.

To add a token, go to the Notebook Variables menu and click the intended token. Or, open the Item menu and add it from there.

You can choose whether the token shows the variable name or its value. Click the token wherever it appears in your notebook and toggle to your preference. Changing one token will not impact other tokens of the same variable throughout the notebook.

Variable tokens in text, with the token menu showing Variable and Value display options. Screenshot.

 

Actions and Buttons

Actions

You can define and run actions in Notebook. Use the Right Arrow symbol (→) to define an action. You can create this symbol with a Hyphen (−) followed by a Greater Than symbol (>) in an expression line. For example, \(a→2\) sets \(a\) to \(2\), and \(a→a+3\) increases \(a\) by \(3\). Click Action Action to run the action once per click. All actions are visible both when editing and viewing a notebook. Learn more in our Actions article.

Expression lines defining two variables and three actions shown. Screenshot.

Add Buttons

Buttons allow you to run actions with a single click from anywhere in your notebook.

Start by defining a notebook variable either in an expression line or by connecting it from a graph. Then, open the Item menu and click Button.

Alternatively, you can add a button directly from the Variable Options or Expression Options of a variable or an expression line that contains the definition of an action.

Adding a button from the Item menu. Screenshot.

Once you add a button, click Button Options Slider Options to change its label and color. In the On Click section, you can specify the action (or multiple actions separated by commas) that the button will run. If you’ve already assigned a variable to an action in your notebook, you can reference it here instead of rewriting the action.

Buttons can be inline with text throughout your notebook, including within columns, headers, or different text alignments. You can’t drag and drop them to place them elsewhere in the notebook, but you can copy and paste them to move them around. Explore buttons in our Simple Button Example notebook.

Button labeled “Add 1” with Button Options open. Screenshot.

 

Log In, Save, and Share Your Notebooks

Create an Account

Although you can use Desmos Notebook without logging in, you’ll need to have an account in order to save or share your notebooks.

If you already have an account from using another Desmos tool, you can use the same account to log in when you use Notebook. Otherwise, click Sign Up to make an account with an email address or with your existing Google or Apple account.

Save Your Notebook

The Save button will turn blue when you make changes to your notebook. Click Save or type Ctrl+S (Windows) or Cmd+S (Mac) to save those changes. If you press Save while logged out, you will be prompted to log in or create an account.

If you’ve previously saved the notebook you are working on, you can also select the More Options More Options dropdown menu to rename or duplicate your notebook.

Access Your Saved Notebook

To access all your saved notebooks, click Open File Open File or type Ctrl+O (Windows) or Cmd+O (Mac). To open any of your saved notebooks, click the notebook’s thumbnail. Or, use your arrow keys to find the thumbnail and then press Enter to open your notebook.

Share a Notebook

Click Share Notebook Share Notebook or use the shortcut Ctrl+Alt+S (Windows) or Ctrl+Cmd+S (Mac) to share your work. Select Share a Snapshot to create a link to the current version of your notebook. People with access to this link won’t see any changes you make to your original notebook. Or, you can select Share Your Saved Notebook to create a link that updates as you save changes to your notebook. Select Print to print a physical copy of your notebook or save as a PDF.

Share Notebook modal. Screenshot.

Preview and View a Notebook

When you share a notebook, people will be able to drag sliders, move points, and interact with other items, but they won’t be able to edit any of the other contents, with the exception of certain expression lines.

Expression Options menu with Hidden and Editable shown. Screenshot.

You can adjust the settings of any expression line to make it invisible or editable to viewers. Click Expression Options and then Hidden to hide that expression from viewers when they look at your shared notebook. Click Expression Options and then Editable to allow viewers to type into that expression line when viewing your shared notebook.

Notebook in Preview mode. Screenshot.

You can check how your shared notebook will appear to others by clicking Preview while in the editor. Or, press Ctrl+Alt+V (Windows) or Ctrl+Cmd+V (Mac).

Share menu dropdown with the Link Opens in Editor checkbox shown. Screenshot.

When sharing, you can click Link Opens in Editor to direct your viewer to the editor instead. Or, you can also go to the editor from any shared notebook by clicking Open in Editor.

 

Learn More

Please write in with any questions or feedback to support@desmos.com.