Repository navigation
Reusing Diagrams
A diagram can live in its own file. You can then show the same diagram in several notes, and every note updates when you save the file.
Use either of these methods:
- Run the command New FlowMotion diagram (.flow file) from the command palette.
- Right-click a folder or file in the file explorer, and select New FlowMotion diagram.
A .flow file can contain a YAML/JSON definition or a supported text DSL. The content selects the format. A .drawio.flow file contains a drawing rather than YAML. For the editor's features, see Editing and help.
To convert an existing .yaml, .yml, or .json file, right-click it and select Convert to FlowMotion diagram (.flow).
Place a flowmotion block in your note that contains a src: line:
```flowmotion
src: ./diagram1.yaml
height: 60vh
controls: true
```Supported file types are .flow, .yaml, .yml, .json, .drawio.flow, and .drawio.svg. The last two are draw.io drawings. See draw.io drawings.
- The path in
src:is relative to the note. Use../to go up one folder. - A path that starts with
/is relative to the top of the vault. - Saving the diagram file redraws every note that shows it.
- Select ✎ Edit on the embedded diagram to edit the file.
You can add these options next to src:. They override the settings stored in the file.
| Option | What it does | Example |
|---|---|---|
src |
Path to the diagram file | src: ./flow.flow |
controls |
Shows the playback controls | controls: true |
interactive |
Waits for Next to play one beat or event interval | interactive: true |
controlsPosition |
Places the controls at the top or bottom
|
controlsPosition: bottom |
mode |
Sets the screen mode to fit or normal
|
mode: normal |
height |
Sets the maximum height |
height: 60vh or height: 500px
|
width |
Sets the maximum width |
width: 70%, width: 900px, or width: 80vw
|
header |
Shows the step label above the diagram (storyboards only) | header: true |
footer |
Shows the caption below the diagram (storyboards only) | footer: true |
paper |
Sets the background behind a draw.io drawing | paper: dark |
A bare number for height or width is read as pixels.
Only src and these display options may appear in an embed. Other definition keys belong in the referenced file. For defaults, path resolution, and compatible units, see the authoring reference.
Warning: FlowMotion does not update your notes when you rename or move a diagram file. The embed then shows FlowMotion: file not found.
To fix it, open the note in Source mode, and change the src: line to the new path.
- Appearance and backgrounds explains the screen modes and the backgrounds.
- draw.io drawings explains how to animate draw.io files.
© 2026 @vrsarin. FlowMotion documentation.