Blog

Tutorials, guides, and best practices for UML diagramming

Series

·17 min read·Featured

PlantUML Examples: Diagrams, Syntax, and Workflows

Explore copyable PlantUML examples for sequence, class, ER, C4, activity, component, and state diagrams, then learn how to style, save, and export them.

plantuml-examplesplantuml-diagramplantuml-syntaxplantuml-diagramsplantuml-example
·8 min read

PlantUML Layout Guide: Direction, Spacing, and Nested Boxes

Control PlantUML layout with direction, containers, spacing, layout engines, and restrained relationship hints without fragile positioning hacks.

plantumlplantuml-layoutnested-boxesdiagram-layout
·7 min read

PlantUML Newpage Not Working? Rendering and Output Fixes

Learn why PlantUML newpage shows one image in OnUML and split long sequence diagrams into tabs that can be previewed, saved, and exported.

plantumlplantuml-newpagepage-breaktroubleshooting
·9 min read

PlantUML Sequence Diagram: Syntax and Real-World Examples

Build authentication and REST API flows with PlantUML participants, messages, activation bars, conditions, loops, and numbering.

plantumlsequence-diagramumlapi-design
·8 min read

PlantUML WYSIWYG Editor: Can You Drag and Drop Diagrams?

Learn what WYSIWYG and drag-and-drop mean for PlantUML, what the language supports, and how to choose between text-first, visual, and hybrid editors.

plantumlplantuml-wysiwyg-editordrag-and-dropdiagram-editor
·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