Skip to content

Reusing Diagrams

Vivek Sarin edited this page Nov 20, 2026 · 2 revisions

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.

Create a diagram 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).

Show a diagram file in a note

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.

Display options

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.

Important: renaming or moving a diagram file

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.

Related pages

Clone this wiki locally