Back to Editor

Blog & Articles

Insights, tutorials, and guides on diagramming as code.

Why Diagram-as-Code is the Future of Software Documentation

Explore why engineering teams are rapidly abandoning drag-and-drop tools in favor of code-based diagramming solutions like Mermaid.js for better version control and efficiency.

Read article →

A 10-Minute Guide to Mermaid Flowcharts

Learn the basics of creating beautiful flowcharts using Mermaid syntax. This quick tutorial covers nodes, links, styling, and practical examples to get you started immediately.

Read article →

Top 5 Architecture Diagram Tools for Developers in 2026

A comprehensive review of the best tools for creating software architecture diagrams this year, comparing features, learning curves, and integration capabilities.

Read article →

Mastering Mermaid Sequence Diagrams for API Design

Sequence diagrams are essential for understanding microservices communication. Learn how to map out complex API interactions, activations, and parallel requests with Mermaid.

Read article →

Mermaid.js vs PlantUML: Which is Right for You?

A detailed comparison of the two biggest names in Diagram-as-Code. We break down the differences in syntax, rendering engines, and ecosystem support.

Read article →

How to Natively Embed Mermaid Diagrams in Markdown

GitHub, GitLab, and Notion now support Mermaid natively. Discover how to write diagram code blocks directly in your README files to keep documentation in sync with your source code.

Read article →

Best Practices for Agile Architecture Documentation

Heavy, monolithic architecture documents are dead. Learn how agile teams are documenting architectures using the C4 model and dynamic Mermaid diagrams.

Read article →