“Now you can quickly create and edit diagrams in markdown using words with Mermaid support in your Markdown files.”
Diagrams as text means they live in the repo and change with the code. That beats a stale PNG exported from a tool nobody can find. The catch is the rendering. It needs JavaScript, so anywhere outside GitHub you just see the raw code block. One more way your docs quietly depend on GitHub.