As an architect, I meandered last few years from one to another "graph as a markup" solution. Until I found Mermaid.
Very often diagram is the best way to explain some question or give an non trivial answer.
I dare to say the Mermaid extension to the SO Markdown engine might be a very effective solution. MD would look like this:
```mermaid
graph LR
A --- B
B-->C[fa:fa-ban forbidden]
B-->D(fa:fa-spinner);
```
As an mature example, this kind of Markdown, is present and in use in HUGO "Learn" theme behind a "HUGO" static CMS, documentation site.
Integration might be even described as "simple". See here.