There are many tools out there for ""writing"" your graphs and design diagrams, one the best ones by far is Mermaid.

It is supported out-of-the box by many tools including Notion and Github. It makes it very easy to use without any extra steps.

Using Mermaid, you can have a readable, maintainable text that represents your visuals. You can think of it as visuals as code.

Being able to use the same tools you use for coding for creating your visuals in the documentation is amazing, and is a great addition to already great Markdown language.