Choose based on the diagram you need to maintain and where it must render: use Mermaid or PlantUML when you want diagrams defined as text, and consider an AWS-listed visual tool when you prefer graphical editing or need to work with AWS architecture icons. These are not three equivalent formats. Mermaid and PlantUML are text-based diagram languages and renderers; AWS provides icon assets and lists third-party diagramming products.
How the three options differ
| Option | What it is | Best starting point |
|---|---|---|
| Mermaid | A JavaScript-based diagramming and charting tool that renders Markdown-inspired text definitions. | Documentation or code workflows where a supported diagram type can be maintained as text. |
| PlantUML | A separate text diagram language. Its 1.2025.0 reference documents AWS and C4 libraries. | Text-authored diagrams where those documented libraries fit the model. |
| AWS diagram tools | A broad category of visual products, alongside AWS-provided architecture icon assets. | Graphical authoring or workflows that use AWS service icons. |
Mermaid and PlantUML are not AWS products, and AWS’s icon collection is not itself a diagramming format. AWS’s directory lists products including Cacoo, Creately, Cloudcraft, draw.io, and Figma, but it does not rank them or establish equivalent features, prices, or integrations. AWS architecture icons and tools
As an Amazon Associate I earn from qualifying purchases.
When Mermaid is the right choice
Mermaid’s overview lists flowcharts, sequence diagrams, use-case and Gantt diagrams, class diagrams, Git graphs, user journeys, quadrant charts, and other chart and diagram types. It can be embedded in applications and production scripts, and its official overview links to a Live Editor for creating diagrams without first integrating a renderer. Confirm that the platform where your documentation will appear supports the Mermaid version and diagram type you plan to use. Mermaid: About
Recommended Free Tools
For cloud architecture diagrams
Mermaid documents its architecture-beta syntax starting with Mermaid v11.1.0. The syntax uses groups, services, edges, and junctions. Some layout features require later versions: align is documented for v11.16.0 and later, while randomize is documented for v11.14.0 and later. The documentation also warns that conflicting alignment and edge direction can prevent a diagram from rendering. Check the renderer version in your actual destination, not just the version used while drafting. Mermaid architecture diagram documentation
#1 Best Overall
When PlantUML is the right choice
PlantUML is a distinct text-based diagram language, not a Mermaid variant. PlantUML’s Language Reference Guide 1.2025.0 documents an Amazon Labs AWS library in its standard library, with sprites, macros, and includes for AWS services and resources. The guide says these elements are generated from official AWS Architecture Icons, and it also lists a C4 library.
That makes PlantUML a relevant option when you want text-authored diagrams and its documented AWS or C4 libraries suit your needs. The guide establishes the libraries’ presence in that reference; it does not guarantee that a particular hosting platform includes them. Verify the standard-library version and rendering environment your team will use.
Rank #2
When to choose an AWS-listed visual tool
Consider a graphical tool if you prefer to create and edit diagrams visually rather than maintain text definitions, or if your workflow depends on using AWS architecture icons. AWS publishes approved architecture icons and toolkits and lists third-party diagramming providers. Its directory is a starting point, not a comparative review: check each vendor’s current editing, collaboration, output, integration, and pricing details directly.
Icon freshness matters. AWS advises users to check third-party libraries for currency because some contain legacy icon sets. AWS says icon packages are released in Q1, Q2, and Q3, with no Q4 release. If recognizable AWS service icons are important, check the asset version used by the tool or library rather than assuming it is current. AWS architecture icons
Rank #3
- Sold as 1 Each.
- All Grades. Helpful for visual learners, this book dissects sentences so students are better able to grasp the writing concepts behind it.
- Provides opportunities to segment the parts of sentences for better understanding of the English language.
- Includes an answer key and glossary.
- 48 pages.
Choose by diagram, workflow, and renderer
- Identify the diagram type. Start with the artifact you need—a sequence view, class model, or cloud architecture view—and verify support in the renderer you will actually use. Mermaid’s overview documents a broad set of types; the PlantUML reference cited here establishes its AWS and C4 libraries, not a complete feature comparison.
- Decide how the team will maintain it. Mermaid and PlantUML use textual definitions. If the team prefers a visual editor, evaluate an AWS-listed drawing tool. AWS’s directory does not compare those products’ editing or collaboration capabilities.
- Check icon requirements. If AWS service icons matter, compare the PlantUML AWS library and its version with the official AWS icon package available in your chosen visual tool. AWS warns that third-party libraries may lag behind current assets.
- Pin or verify renderer versions. For Mermaid architecture diagrams, confirm v11.1.0 or later; check the higher documented thresholds if you rely on
alignorrandomize. For PlantUML, verify that the needed standard library is available in the team’s renderer. - Test in the final destination. Render a representative diagram in the documentation site, code host, presentation workflow, or publishing system where readers will see it. Mermaid documents embedding and production-script use, but support and feature parity vary by host and are not established for every platform.
A practical recommendation
- Choose Mermaid for text-maintained diagrams when its documented diagram types and the destination renderer meet your needs.
- Choose PlantUML when you want a text-based diagram language and its documented AWS or C4 libraries fit your use case, after confirming the rendering setup.
- Choose an AWS-listed visual tool when graphical editing is a better fit or you need AWS icon assets in a visual workflow; evaluate the specific product and check its icon currency.
There is no universal winner: the decision turns on the diagram, authoring workflow, icon needs, and compatibility of the renderer in the place the diagram must live.
Quick Recap
Best Value
Rank #4
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
