Repository navigation
Your First Diagram
This page shows how to add a diagram to a note, edit it, and play it.
- Open a note.
- Right-click in the note and select Add FlowMotion diagram.
- Select Inline diagram.
- 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.
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.
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.
- Writing diagrams: shapes, arrows, groups, and colours.
- Diagram types: flowcharts, Gantt charts, mind maps, and more.
© 2026 @vrsarin. FlowMotion documentation.