Building Diagramming Momentum
• 5 mins
[Mermaid Feature Drop] Your work moves fast. Your diagrams should too. This release brings richer AI context, zero-code editing, instant sharing, and enterprise security so your documentation can finally keep pace. Here’s what’s new:
- Upload files to AI for context-aware diagrams
- Build Requirement Diagrams visually with no syntax needed
- Share by link with no login required
- Generate diagrams with Claude via our new MCP server
- Enterprise-ready: SSO + SOC 2
Upload files to AI for context‑aware diagrams
Documentation doesn’t live in a vacuum. It lives across meeting transcripts, design docs, PRDs, screenshots, and code snippets scattered throughout your workflow. Now you can drop all of it directly into Mermaid AI. Each conversation remembers everything you’ve uploaded, so you can refine diagrams as requirements shift — no need to start over or re-explain context every time you iterate.
How it helps: Turn a 30-page design doc into a system architecture diagram in seconds. Convert messy meeting notes into a clean sequence flow. Transform a dense PRD into a visual Requirement diagram. Then iterate as the project evolves: add new features, adjust flows, update dependencies, all without losing the thread.
Try it: Upload a requirements doc and ask “Create a system overview with auth flow.” Review it, then follow up with “Add a caching layer and external API calls.” The AI remembers your initial context, so your diagram grows naturally with your thinking instead of forcing you to rebuild from scratch.
Build Requirement Diagrams visually (no code needed)
Requirement diagrams map what your system needs to do and how those needs connect. They’re essential for planning, traceability, and keeping engineering aligned with stakeholders. These diagrams are powerful for complex systems, but they’ve historically required using Mermaid syntax before you could build. Now you can build them entirely in the Visual Editor, with code generating automatically as you work.
The workflow:
- Add requirement nodes and set types: Functional, Interface, Performance, Physical, or Constraint
- Define relationships by dragging connections between nodes (choose from satisfies, verifies, derives, traces, refines, or copies)
- Edit properties inline as your requirements evolve, or switch to code view when you need to fine-tune syntax
Work visually when you’re brainstorming or collaborating, then toggle to code view when you need precision. You never have to leave your flow. Best of both worlds.
Share diagrams with a simple link (no login required)
You’ve built the diagram. Now you need stakeholder eyes on it quickly. But coordinating accounts, permissions, and access can take longer than creating the diagram itself. Now you can send a public view-only link. Anyone with the link can view it instantly — no account creation, login wall, or IT coordination required.
It’s perfect for:
- Design reviews with external partners who don’t need (or want) full platform access
- RFC feedback loops where you need quick input from cross-functional teams
- Sprint planning where PMs, designers, and engineers need to align on architecture before kickoff
- Client handoffs where you need visibility without adding friction
Zero barriers between your diagram and the feedback you need.
Claude speaks Mermaid (via a new MCP server)
Our new Model Context Protocol (MCP) server lets you ask Claude to create, fix, or evaluate Mermaid diagrams in natural language. The server validates syntax, produces clean PNGs, and returns shareable links you can open directly in Mermaid for editing or collaboration. This is the first step toward truly AI-native diagramming — programmatic, reliable, and tool-agnostic.
For developers: Connect directly to our remote MCP server (https://mcp.mermaidchart.com/mcp) to automate diagram generation or validation in your own workflows. Generate architecture diagrams from ticket descriptions. Validate syntax in CI/CD pipelines. Build custom integrations that turn text into visual documentation. Works with Claude today, and integrates with dev tools like Cursor.
Why it matters: You can now jump from a chat draft to a production-ready diagram in seconds. No manual syntax translation, copy-paste errors, or reformatting. Just describe what you need, and let Claude handle the technical implementation.
→ Get started with the MCP server
Enterprise-ready: SSO and SOC 2
As teams scale, so do security and compliance requirements. That’s why we built Mermaid to meet you there.
Single Sign-On (SSO) gives your IT team centralized access control and makes onboarding smoother for new team members — no more password sprawl or manual account provisioning. SOC 2 compliance means our security practices are independently audited and verified, so you can confidently meet governance requirements without lengthy internal reviews.
Whether you’re navigating enterprise procurement, responding to security questionnaires, or just want peace of mind that your diagrams are protected, we’ve got you covered.
Small improvements that add up
We shipped a handful of refinements this month that shave clicks, reduce friction, and speed up your workflow:
- Edit AI-generated diagrams instantly: Hit “Edit Diagram” directly from your AI chat (you won’t have to navigate away and hunt for the file)
- Faster navigation: Jump to your homepage from the editor to see all diagrams at a glance (especially helpful when you’re juggling multiple projects)
- Streamlined comments: Notification clicks now open directly to the live conversation thread instead of making you scroll to find context
- Cleaner exports: Faster PNG renders with sharper quality, plus support for invisible or custom backgrounds when you need polished assets for presentations
What to try this week:
- Upload a transcript or design doc to AI Chat → generate a working diagram that captures the structure you need
- Create a Requirement diagram visually to map dependencies for your next sprint (no syntax required)
- Submit a question for our December AMA on Mermaid AI, visual editing, or content management