Mermaid Visualizer

Overview

Convert text content into clean, professional Mermaid diagrams optimized for presentations and documentation. Automatically handles common syntax pitfalls (list syntax conflicts, subgraph naming, spacing issues) to ensure diagrams render correctly in Obsidian, GitHub, and other Mermaid-compatible platforms.

Quick Start

When creating a Mermaid diagram:

1. Analyze the content - Identify key concepts, relationships, and flow
2. Choose diagram type - Select the most appropriate visualization (see Diagram Types below)
3. Select configuration - Determine layout, detail level, and styling
4. Generate diagram - Create syntactically correct Mermaid code
5. Output in markdown - Wrap in proper code fence with optional explanation

Default assumptions:

• Vertical layout (TB) unless horizontal requested
• Medium detail level (balanced between simplicity and information)
• Professional color scheme with semantic colors
• Obsidian/GitHub compatible syntax

Diagram Types

1. Process Flow (graph TB/LR)

Best for: Workflows, decision trees, sequential processes, AI agent architectures

Use when: Content describes steps, stages, or a sequence of actions

Key features:

• Swimlanes via subgraph for grouping related steps
• Arrow labels for transitions
• Feedback loops and branches
• Color-coded stages

Configuration options:

• layout: "vertical" (TB), "horizontal" (LR)
• detail: "simple" (core steps only), "standard" (with descriptions), "detailed" (with annotations)
• style: "minimal", "professional", "colorful"

2. Circular Flow (graph TD with circular layout)

Best for: Cyclic processes, continuous improvement loops, agent feedback systems

Use when: Content emphasizes iteration, feedback, or circular relationships

Key features:

• Central hub with radiating elements
• Curved feedback arrows
• Clear cycle indicators

3. Comparison Diagram (graph TB with parallel paths)

Best for: Before/after comparisons, A vs B analysis, traditional vs modern systems

Use when: Content contrasts two or more approaches or systems

Key features:

• Side-by-side layout
• Central comparison node
• Clear differentiation via color/style

4. Mindmap

Best for: Hierarchical concepts, knowledge organization, topic breakdowns

Use when: Content is hierarchical with clear parent-child relationships

Key features:

• Radial tree structure
• Multiple levels of nesting
• Clean visual hierarchy

5. Sequence Diagram

Best for: Interactions between components, API calls, message flows

Use when: Content involves communication between actors/systems over time

Key features:

• Timeline-based layout
• Clear actor separation
• Activation boxes for processes

6. State Diagram

Best for: System states, status transitions, lifecycle stages

Use when: Content describes states and transitions between them