Skip to main content

31 posts tagged with "diagrams"

View All Tags

Mermaid AI Agent for Confluence: Create, Update & Convert Diagrams by Chat

· 5 min read

Confluence chat can write your page, summarize the thread, and answer questions about the space. What it couldn't do — until now — is draw. If you asked for "a flowchart of our deployment process," you got a text description of a flowchart, and someone still had to open an editor and build it.

The AI agent in Mermaid Plus Diagrams & AI Agent for Confluence closes that gap: it creates, reads, updates, and converts Mermaid diagrams directly on Confluence pages and blog posts, from chat.

draw.io vs Mermaid in Confluence: Which Fits Your Docs?

· 16 min read
Quick Answer

draw.io supports Mermaid now — so "does draw.io do Mermaid?" is no longer the question. The question is what the source becomes. In Mermaid Plus Diagrams & AI Agent for Confluence, the Mermaid text stays the diagram: page history shows a text diff, an update is one line, and a Rovo agent can create, read, update or convert diagrams from chat. In draw.io, Mermaid is an import step that turns the diagram into native draw.io shapes, so you get full styling and shape-library freedom but the page holds shape data instead of reviewable text. On the AI side the difference is where the processing happens: Mermaid Plus runs on Atlassian Forge with Atlassian's own Rovo agent, so the diagram and the AI both stay inside the Atlassian trust boundary, covered by your existing Atlassian agreement. Text-first docs → Mermaid Plus. Visual-first, icon-heavy or migration-heavy work → draw.io.

What you'll learn
  1. What changed when draw.io added Mermaid support in 2026
  2. Where the two tools genuinely differ, and where they do not
  3. How the AI features compare — canvas generation vs a Rovo agent on the page
  4. Where the diagram and the AI data live, and why that decides it for enterprise teams
  5. A decision framework for Confluence and Jira teams

Every Confluence team ends up choosing a diagram tool, and most start by asking the wrong question: does it support Mermaid? These days, two answers exist. Mermaid Plus Diagrams & AI Agent for Confluence is built around Mermaid — all 30 Mermaid v12 diagram types, a code editor with live preview, one-click templates for every type, and a Rovo AI agent that works on the page. draw.io is the most-installed diagramming app on the Atlassian Marketplace, with deep shape libraries, whiteboarding, and a Mermaid importer added to its editor.

Both are good tools. This guide compares how they behave in Confluence specifically — how a diagram is created, what is stored on the page, what happens when you need to change it six months later, and what it costs.

Mermaid 12 in Confluence & Jira: UML Use Case Diagrams and a New Look

· 5 min read

Mermaid 12 is the biggest release the diagram language has had in years — and as of today it is live in all three NGPILOT diagram apps: Enhanced Markdown for Confluence, Mermaid Plus Diagrams & AI Agent for Confluence, and Mermaid Plus Diagrams for Jira. You get the headline feature immediately: UML use case diagrams, the diagram type Confluence and Jira teams have been asking for since requirements documents moved out of dedicated UML tools.

From Markdown Notes to a Mind Map in Confluence — No Drawing

· 4 min read

Meeting notes, project briefs, planning docs — most Confluence pages already start life as a Markdown-ish outline: a title, some headings, bullets underneath. A mind map is just that outline seen from above. This guide shows how to get from the outline you already have to an interactive mind map on the page, without drawing anything and without learning diagram syntax.

How to Create a Flowchart in Jira — 3 Methods with Copy-Paste Examples

· 6 min read

Jira is where the work happens — but the process behind the work usually lives in someone's head or in a stale Confluence page nobody opens. A flowchart on the Jira issue itself fixes that: bug triage paths, approval chains, and escalation procedures become visual, unambiguous, and impossible to miss.

Jira Cloud gives you two ways to get there, and they serve different needs. This guide walks through both, then gives you three copy-paste Mermaid flowchart examples for the scenarios Jira teams hit most: bug triage, approval workflows, and incident escalation.

Mermaid vs PlantUML vs Graphviz for Confluence: Which Diagram Tool to Choose

· 7 min read
Quick Answer

Mermaid, PlantUML, and Graphviz are the three most popular text-based diagramming languages. Mermaid is the easiest to learn and covers the widest range (30 diagram types). PlantUML excels at detailed UML with precise notation control. Graphviz is best for technical network and dependency graphs. Most Confluence teams should start with Mermaid and add Graphviz for network diagrams if needed.

What you'll learn
  1. The strengths and weaknesses of each tool
  2. Which diagram types each one supports
  3. How easy each is to learn and use
  4. A practical recommendation for Confluence teams

Text-based diagramming — writing a few lines of code that render into a diagram — is how modern teams keep diagrams in sync with their documentation. No more drawing boxes by hand in Visio, exporting screenshots, and pasting them into Confluence where they go stale. With text-based diagrams, you edit the source and the diagram redraws instantly.

But there are three major text-based diagramming languages, and they are not interchangeable. Each has different strengths, different syntax, and different ideal use cases. This guide compares Mermaid, PlantUML, and Graphviz so you can choose the right one (or combination) for your Confluence team.

Mermaid Diagrams for Jira Sprint Workflows — Which Diagrams Actually Help the Standup

· 9 min read
Who should read this
  • Scrum masters and eng leads who run standups from Jira
  • Development teams deciding which diagrams to maintain across a sprint
  • Anyone who wants to know which of Mermaid's 30 diagram types are actually useful for agile work
What you'll learn
  1. The four Mermaid diagram types a sprint team actually reaches for
  2. How to embed each one inside a Jira issue, with copy-paste syntax
  3. When a diagram belongs in Jira vs. Confluence
  4. The full 30-type reference for less common needs

Every team that adopts Jira diagrams hits the same moment: you discover Mermaid supports 30 diagram types, you get excited, and then you realize you have no idea which ones to actually use during a sprint. Most of them never get drawn. The diagrams that earn their keep are the ones that make a standup faster, an onboarding doc clearer, or a ticket unambiguous — and those are a small, repeatable subset.

This post is the workflow guide we wish we'd had: the four diagram types a sprint team actually uses, each with a real scenario and copy-paste syntax you can drop straight into a Jira issue. The full 30-type reference follows, so the same page works as both a sprint playbook and a complete catalog.

Whiteboarding Architecture Sessions in Jira & Confluence

· 7 min read
Who should read this
  • Engineering teams that sketch architecture during planning and design reviews
  • Tech leads who want design decisions captured on the ticket, not lost in a photo
  • Anyone comparing freehand whiteboarding vs. text-based (Mermaid) diagramming
What you'll learn
  1. How to run an architecture whiteboarding session that stays attached to the Jira epic
  2. When freehand sketching beats structured diagrams (and vice versa)
  3. Using 229 cloud/UML/networking shape libraries inside Jira
  4. How Excalidraw and Mermaid complement each other

Every architecture review ends the same way: the team sketches a system on a whiteboard, someone takes a blurry phone photo, and the diagram is never seen again. The next sprint a new engineer joins, asks how the system fits together, and the whiteboard gets redrawn from memory — different every time.

The fix is to capture the architecture sketch on the ticket it describes, editable by anyone on the team, versioned with the issue. That's what Excalidraw Diagrams plus Whiteboards for Jira does: it adds a full drawing canvas to every Jira issue, with 229 bundled shape libraries and freehand drawing. The same experience is available in Confluence via Excalidraw plus Whiteboards for Confluence. This guide walks through running an architecture session that produces a saved, shareable diagram.

Best Confluence Apps & Plugins in 2026 — Developer Tools Compared

· 7 min read

Developer teams use Confluence differently than marketing or HR. You document APIs, share architecture diagrams, write runbooks, and collaborate on code reviews. The default Confluence editor works, but it wasn't built for technical documentation.

This guide covers the best Confluence apps for developers in 2026, organized by use case. We built several of these apps at NGPILOT, so we'll be transparent about where our apps fit and where competitors offer better solutions.