Using the canvas

The Canvas lets you lay out your work visually. It’s great for synthesizing your work into a story: you can arrange nodes you’ve already created into a canvas layout, or generate new nodes directly from the canvas itself.

Creating a canvas

From anywhere

Type jj followed by canvas anywhere in your graph to create and title a canvas. The canvas is created as a separate page in your graph.

From a project page

You can also create a canvas to represent your current projects directly from the Project page:

Creating a canvas from a Project page

This canvas is automatically named after the project it was generated from. Once created, you can use the Project Canvas button to navigate to the Project canvas.

Adding nodes to your canvas

Add nodes to your canvas by selecting the discourse graph symbol on the taskbar at the bottom of the canvas pane. This opens the node selection menu — select a node type, then click on your canvas to place the node.

Open the node selection menu by clicking on the discourse graph symbol in the lower toolbar

Placing a node on your canvas opens the node title menu. As you type the name of the node, the form autocompletes with the names of nodes already in your graph. You can select one of these existing nodes or create a new one.

Selecting nodes to add to your graph

Connecting discourse nodes with relations

You can make the connections between your discourse nodes more informative and explicit by adding relations. For example, an Evidence node might Inform a Question node, or Support a Claim.

To create a relation, click the discourse graph symbol in the lower toolbar and select the appropriate relation arrow, then drag the arrow between nodes.

Using the relation menu

You can also create a relation on your canvas by clicking on the origin node until the grey drag handles appear and dragging the relation arrow to the target node. You will be prompted to select from one of the available relation types for those nodes.

Creating a relation using the node drag handles

Managing canvas content

The canvas drawer

As you add nodes to your canvas, they’re also added to the Canvas Drawer. Use this drawer to jump straight to a particular node on your canvas by clicking the target icon next to its title — a feature that becomes more useful as your canvas gets busier. The canvas Drawer also highlights any duplicate nodes in your canvas.

Rummaging through the canvas drawer

The clipboard

Use the Clipboard to keep track of what’s on the canvas and what should be on the canvas. It allows speedy bulk importation of all the nodes from a particular page or set of pages.

The clipboard icon

Open the Clipboard by clicking the discourse graph icon in the bottom toolbar, which causes the Clipboard icon to appear. You can use the Clipboard to search for pages with content relevant to your canvas.

Searching for pages to add to the clipboard

All the discourse nodes found on pages you import to your Clipboard are listed as options to add to your canvas. If a node in the Clipboard is already on the canvas, clicking it navigates to that node.

Viewing clipboard content

You can drag nodes not already on your canvas onto your canvas from the Clipboard.

💡

If you enable the Key Image setting in the Discourse Graph Settings menu for a particular node type, any nodes you drag to your graph will bring along the first image from that page.

💡

You can also specify a particular image to use by entering its block reference (right-click the bullet next to the image and select “Copy block ref”) in the “Query builder reference” field shown above.

The sidebar

Clicking the sidebar icon on any node opens that node’s page in your sidebar.

The sidebar icon

You can use this side-by-side view to move images or text from that node’s page onto your canvas.

Viewing sidebar content next to your canvas

Sending query results to the canvas

To export multiple results from a query run in your graph to a canvas, open the query table menu and select Share Data → Send to Page, then either select an existing canvas or create a new one to receive the results.

sending query results to your canvas

Converting images or text into discourse nodes

You can select images or text from your graph, a document, a file, or a webpage, copy them to your canvas, and convert them into discourse nodes. Right-click the image, select “Convert to…”, then modify the title as needed.

Converting an image to an evidence node

Converting text to a result node

Synchronizing your canvas and graph

Nodes created on the canvas are added to your graph. Edits made to node titles on your canvas are propagated to your graph — this can take a few moments, or until your next page refresh.

Annotating your canvas

The canvas has additional features to help with visual sensemaking of your discourse graph. You can use freehand drawing tools to annotate images or the canvas itself, and add text boxes and shapes for additional context around discourse nodes and relations.

Adding text boxes and shapes to a canvas

Adding video to a canvas

Stickers, arrows, GIFs, YouTube videos — anything that enhances understanding or presentation. These features can come in handy during a live or recorded canvas walkthrough.

Exporting your canvas

The canvas can be exported as an SVG, PNG, or JSON by right-clicking the canvas, or from the menu in the top-left corner via Export. You can also selectively copy and export specific canvas elements.

Choosing a format for canvas export

Viewing your canvas in full-screen mode

Type Shift + 3, or click the menu icon → View → “Toggle Full Screen”.