Blog

Tutorials, guides, and best practices for UML diagramming

Series

·7 min read

Mermaid vs PlantUML ER Diagrams: Application Schemas

Use Mermaid Crow's Foot notation for application schemas and PlantUML Chen notation for conceptual models. Compare keys, cardinality, scope, and tradeoffs.

mermaidplantumler-diagramerddatabase-designdiagram-as-code
·9 min read

Mermaid vs PlantUML Architecture Diagrams Compared

Use Mermaid for service and resource maps, and PlantUML for component contracts, deployment views, C4 baselines, and formal architecture documentation.

mermaidplantumlsoftware-architecturearchitecture-diagramdeployment-diagramdiagram-as-code
·7 min read

Mermaid vs PlantUML State Diagrams: Formal State Machines

Compare Mermaid and PlantUML for composite states, concurrent regions, history states, and entry or exit points in production state-machine documentation.

mermaidplantumlstate-diagramstate-machinediagram-as-codeuml
·7 min read

Mermaid vs PlantUML Activity Diagrams: Which Is Better?

Compare Mermaid Flowchart and PlantUML activity syntax for branches, loops, fork/join, and early exits. Learn why formal activity models favor PlantUML.

mermaidplantumlactivity-diagramflowchartdiagram-as-codeuml
·9 min read

Mermaid C4 vs C4-PlantUML: Choosing a Formal C4 Standard

Mermaid C4 remains experimental as of July 22, 2026. Compare its five views, documented limits, formal architecture fit, and governance with C4-PlantUML.

mermaidplantumlc4-modelc4-diagramsoftware-architecturediagram-as-code
·8 min read

Mermaid vs PlantUML Class Diagrams for Formal UML Models

Compare Mermaid and PlantUML class diagrams for relationships, namespaces, association classes, view trimming, and maintainable formal UML documentation.

mermaidplantumlclass-diagramdiagram-as-codeuml
·7 min read

Mermaid vs PlantUML Swimlane Diagrams for Process Design

OnUML uses Mermaid 11.6.0, where subgraph only approximates lanes. Compare it with 11.16.0 swimlane-beta and PlantUML activity swimlanes for role ownership.

mermaidplantumlswimlane-diagramactivity-diagramflowchartdiagram-as-code
·10 min read

Mermaid vs PlantUML Sequence Diagrams: Complex Flows

Mermaid covers six common control fragments. PlantUML adds dedicated return, autoactivation, reference, and pagination syntax for complex interaction flows.

mermaidplantumlsequence-diagramdiagram-as-codeuml
·7 min read·Featured

Mermaid vs PlantUML: Everyday Docs or Complex Architecture?

Choose Mermaid for everyday documentation and PlantUML for formal UML or complex architecture. Compare capabilities, version limits, and delivery scenarios.

mermaidplantumldiagram-as-codeumlsoftware-architecture
·17 min read·Featured

Mermaid Flowchart Guide: Syntax, Examples & Best Practices

Learn Mermaid flowchart syntax with practical examples for authentication, CI/CD, microservices, error handling, SSO, and e-commerce workflows.

mermaidflowcharttutorialdiagramsystem-design