Installation

Mermaid Studio is available in two editions. Choose the one that fits your needs:

	Mermaid Studio Core	Mermaid Studio
Price	Free (optional Core license: $49/yr)	$99/yr (30-day free trial)
Free features	Syntax highlighting, preview, export for all 26 types	—
Paid features	Inspections, completions, formatting, refactoring for 6 core types	—

Not sure which to choose? Compare editions in detail →

Caution

The two editions cannot be installed at the same time. If you switch, uninstall the current edition first.

Installation

Mermaid Studio Core

1. Open your JetBrains IDE (IntelliJ IDEA, WebStorm, PyCharm, etc.)

2. Open Settings ( Command + Comma Command, Control + Alt + S CtrlAltS )

3. Navigate to Plugins > Marketplace

4. Search for “Mermaid Studio Core”

5. Click Install

6. Restart your IDE when prompted

Or install from the web: Mermaid Studio Core on JetBrains Marketplace

Mermaid Studio

1. Open your JetBrains IDE (IntelliJ IDEA, WebStorm, PyCharm, etc.)

2. Open Settings ( Command + Comma Command, Control + Alt + S CtrlAltS )

3. Navigate to Plugins > Marketplace

4. Search for “Mermaid Studio”

5. Click Install

6. Restart your IDE when prompted

Or install from the web: Mermaid Studio on JetBrains Marketplace

System Requirements

• IDE Version: IntelliJ IDEA 2025.1 or later (or equivalent version for other JetBrains IDEs)
• Platform: Windows, macOS, or Linux
• MCP Tools: Requires IDE version 2025.2 or later (the MCP Server plugin is not available in 2025.1)

Troubleshooting

Plugin not appearing after installation

• Ensure you’ve restarted your IDE completely
• Check Settings > Plugins > Installed to verify the plugin is enabled
• Check the IDE log for errors: Help > Show Log in Finder/Explorer

Syntax highlighting not working

• Verify the file has a recognized extension (.mmd, .mermaid)
• Check that the plugin is enabled in Settings > Plugins > Installed

Diagrams not rendering in markdown preview

Ensure the markdown preview is set to use Mermaid Studio:

1. Navigate to Settings > Languages > Frameworks > Markdown

2. Make sure the Preview rendering engine setting is set to Mermaid Studio (Chromium Browser)