Use the Mermaid diagrams block in Workspace

The Mermaid diagrams block belongs to Workspace Data & Logic. Create and edit diagrams with Mermaid syntax.

What it does

Create and edit diagrams with Mermaid syntax.

When to use it

• Organize structured information.
• Track work, dates, decisions, or data inside a page.
• Turn notes into a more actionable page.

How to add it

1. Open a Workspace page where you have edit access.
2. Type / or open Explore blocks.
3. Choose Mermaid diagrams.
4. Fill in the content, link, file, or settings shown by the block.
5. Use Block Settings when the block exposes additional options.

Tips

• Use Board for draggable task workflows.
• Use Table for row-and-column information.
• Keep labels short so the page remains readable.

Limitations

• You need Editor or Admin access to add or change this block.
• Viewer access allows reading and commenting where comments are enabled, but not editing block content.
• If the block depends on an external file, link, or service, that source must be accessible to the people viewing the page.

Related guides

• Use slash commands.
• Use Workspace blocks.
• Manage blocks.

FAQ

What is the Mermaid diagrams block for? Create and edit diagrams with Mermaid syntax.

Can Viewers edit a Mermaid diagrams block? No. Viewers can view and comment only.