I write a lot of user-facing documentation as well as operational runbacks, and Mermaid makes it extremely simple to include graphics, charts, workflow visualizations, etc. I can include the raw code, which makes it easier for others (or Future Me!) to make changes to lt later on. I can use the web interface or IDE extensions (e.g., VSCode). There are also plugins for Confluence, etc. The syntax isn't overly complicated--basically markdown--but as a lazy person, rather than memorize it, I started using third party AI tools (e.g., Gemini) to describe what I wanted in simple narrative descriptions, and let it create the code for me. Later, I found the native AI capabilities within Mermaid itself made this even easier for realtime chart creation within the mermaid.ai interface. The price is minimal and worth it. I really couldn't have created these diagrams on my own - my skills stopped with MS Paint. The support is also top notch - very personable, responsive.

I like Mermaid Charts best for their simplicity and flexibility in creating diagrams using plain text. You can write a few lines of code to generate flowcharts, sequence diagrams, Gantt charts, or mind maps, which makes them easy to version-control and integrate into documentation. They’re lightweight, easy to update, and ideal for technical teams who want to embed diagrams directly in Markdown, wikis, or code repositories without using heavy graphic tools.

I have been using Mermaid Chart for years, primarily for sequence diagrams and flowcharts, and recently for C4 Context diagrams. I was introduced to it by a colleague and instantly appreciated how it allowed me to keep documentation updated by modifying a central Mermaid diagram. Setting up Mermaid Chart was a breeze because it is a SaaS tool. It allows me to create diagrams using clear text easily. The tool is fantastic in helping me collaborate with end users to translate their ideas into visual diagrams and then quickly iterate on them. This significantly reduces rework as shared understanding of processes is achieved much sooner. The ability to save diagrams as PNGs is particularly useful, and it integrates well with other software like Confluence, DevOps, and Word. What makes it the best diagramming tool for me is its ability to remove the need to manually position objects on a canvas, which is especially beneficial since I have ADHD and can overly focus on such tasks.