docs/developer/how-to/excalidraw.md
# How to embed Excalidraw diagrams
Start off by creating your diagram in <https://excalidraw.com>
```{raw} html
:file: ../../images/excalidraw-example.svg
```
Click 'Save as image' and make sure the 'Embed scene' checkbox is enabled. This is required for loading your image back into Excalidraw should you wish to make changes later on. Name your file and export to SVG, saving it inside `doc/images`.
Add the following to embed it inside your documentation:
``````
```{raw} html
:file: ../../images/excalidraw-example.svg
```
``````
It is preferred to use the above convention over `[]()` in order to retain the font used by Excalidraw.
Rebuild the docs and open the resulting html inside a browser.