Skip to content

Your First Diagram

Vivek Sarin edited this page Nov 16, 2026 · 1 revision

Your first diagram

This page shows how to add a diagram to a note, edit it, and play it.

Add a diagram to a note

  1. Open a note.
  2. Right-click in the note and select Add FlowMotion diagram.
  3. Select Inline diagram.
  4. Edit the starter diagram. It is written in YAML, and the preview updates as you type. To use the text format instead, replace the contents with a text diagram such as flowchart TB. See Writing diagrams.

The diagram is stored inside the note. You can move the note or copy it without any extra file.

If you prefer to keep the diagram in its own file, select Diagram file (.flow) instead. See Reusing diagrams.

Edit a diagram with help

To edit a diagram with help, hover over it and select ✎ Edit. The full editor opens with:

  • Live error checks.
  • Suggestions as you type. Press Ctrl+Space to see them.
  • A live preview.

See Editing and help for the full list of features.

Play a diagram

Diagrams start automatically unless you turn off Autoplay in the settings. Click the diagram to pause it, and click again to play it.

To show the playback controls, select the ⚙ button under the diagram. The controls include ▶ (play or pause), the speed, the step buttons, and a reset button. See Playback and timing.

Next steps

Clone this wiki locally