Blog

Tutorials, guides, and best practices for UML diagramming

Series

Featured

·9 min read·Featured

Mermaid UML Diagrams: Supported Types and Limitations

Learn which UML diagrams Mermaid supports, where it uses approximations, and when to choose sequence, class, state, ER, flowchart, or PlantUML.

mermaidumldiagram-as-codesoftware-designarchitecture
·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
·16 分钟阅读·精选

PlantUML 示例:图表、语法与工作流

探索可复制的 PlantUML 时序图、类图、ER 图、C4 架构图、活动图、组件图和状态图示例,并学习如何设置样式、保存和导出。

plantuml 示例plantuml 图表plantuml 语法plantuml 图表类型plantuml 示例代码
·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
·7 分钟阅读·精选

Mermaid vs PlantUML:日常文档与复杂架构如何选?

日常文档默认 Mermaid,正式 UML 与复杂架构图默认 PlantUML。通过交付物决策、能力矩阵与专项入口,选择适合团队的图表即代码工具。

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
·13 min read·Featured

Mermaid Sequence Diagram: Syntax and Practical Tutorial

Learn Mermaid sequence diagram syntax for participants, messages, notes, activation, control flow, and maintainable API documentation with runnable examples.

mermaidsequence-diagramtutorialapi-documentation
·6 分钟阅读

Mermaid vs PlantUML 状态图:正式状态机默认选 PlantUML

基于 2026-07-22 官方语法核验,对比 Mermaid 与 PlantUML 的普通状态流、复合状态边界、历史状态、进入/退出点和并行区域,给出正式状态机选型。

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
·6 分钟阅读

Mermaid vs PlantUML 活动图:控制流程默认选 PlantUML

聚焦 Mermaid Flowchart 与 PlantUML 活动图的开始结束、分支、循环、fork/join 和提前终止,说明正式活动图为何默认选 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
·10 分钟阅读

Mermaid C4 vs C4-PlantUML:正式 C4 架构图选型

截至 2026-07-22,Mermaid C4 仍为 experimental,支持 5 类图却短期缺 sprite、tags、link、Legend;正式 C4 图优先 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
·6 分钟阅读

Mermaid vs PlantUML 类图:正式 UML 为什么默认选 PlantUML

基于 2026-07-22 官方语法核验,对比 Mermaid 与 PlantUML 的类关系、声明元素、关联类、视图裁剪、嵌套 namespace 与样式治理,给出正式 UML 类图的选型结论。

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
·7 分钟阅读

Mermaid vs PlantUML 泳道图:当前 OnUML 默认选 PlantUML

区分 OnUML Mermaid 11.6.0 的 subgraph 分组与 11.16.0 swimlane-beta,说明为何角色职责和跨泳道交接默认选 PlantUML。

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