Mermaid is great, but is quirky.

LLM's are well-trained on Mermaid. Gemini specifically is fantastic as a 'diagram assistant'. I was able to create this diagram and a ton of other such diagrams quite easily with Gemini and Mermaid's live editor: https://nshkr.com/SecureSphere-Overview-20241102.png

VS Code recently added some AI-related features for Mermaid

https://code.visualstudio.com/updates/v1_95#_mermaid-diagram...

I frequently turn notes about infrastructure, pipelines or databases into diagrams with an LLM to ground my team's understanding.

The VSCode Mermaid plugin and the GH integration make this very simple to do.

Sometimes I feel they are even too much trained on Mermaid. I prefer graphviz but claude very often output a mermaid diagram even if I gave a valid graphviz example in my prompt.

I've been using the same, but with Chatgpt. Multiple iterations are needed to get what I want though. Cool trick is that you could import Mermaid using drawio.

Mermaid is fantastic for diagramming architecture. A little quirky, but not too bad.

If you're using GitHub it's supported in any markdown file, and therefore accessible to any other dev with repo access. No permissions issues, edits can go through code review, and no dependencies necessary.

Same with GitLab. I really appreciate the builtin Mermaid support.

VS Code just released some cool Copilot-related features for Mermaid

https://code.visualstudio.com/updates/v1_95#_mermaid-diagram...

I'm leaning on both Mermaid JS and PlantUML as my daily drivers for diagrams.