Include diagrams in your Markdown files with Mermaid | The GitHub Blog

The most notable thing about this is that GitHub is supporting it so it will be very easy to use. It looks like Mermaid uses the standard DOT graph description language to describe these images. DOT is a powerful tool and a good choice for this. The way that GitHub is rendering these is very polished as well.

There is an interesting extension to go with this — using code to generate the DOT notation and then feed it into GitHub. it would be curious to do software analysis that generates large volumes of DOT files and then puts them on GitHub to render and display. 🤔