Installation

Mermaid Studio can be installed from the JetBrains Marketplace directly within your IDE, or downloaded manually.

Install from IDE

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

Install from JetBrains Marketplace Website

1. Visit the Mermaid Studio plugin page on the JetBrains Marketplace

2. Click Install to IDE and select your IDE

3. Your IDE will open and prompt you to install the plugin

4. Restart your IDE when prompted

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 enginge setting is set to Mermaid Studio (Chromium Browser)