🧜 JetBrains · Markdown · Mermaid

Render Mermaid diagramslive in your IDE

Open a Markdown file, see every mermaid block in a side panel — toggle between diagram and source, live-refresh as you type. No browser tab. No network. No copy-paste.

JetBrains IDEs 2023.3+ · IntelliJ IDEA, PyCharm, WebStorm & more · JCEF required

Available now — v0.1.2

Mermaid Preview — write diagrams in Markdown, render everywhere in your JetBrains IDE
Why Mermaid Preview

Every diagram, renderedwhere you already are

🔍

Auto-detect every block

Scans all fenced ```mermaid``` blocks in your Markdown file and renders each as its own card in the side panel. Open a 500-line doc with 8 diagrams and see them all at once — no scrolling required.

🔄

Per-block toggle

Unique

Each card has a segmented Diagram ↔ Code button. Flip between the rendered output and the raw Mermaid source in one click without losing your place in the editor.

Live refresh as you type

Diagrams re-render with a 250ms debounce as you edit. No save required, no manual refresh button, no context switch. Watch your sequence diagram or flowchart evolve in real time.

🌙

Theme-aware rendering

Follows your IDE's dark or light theme automatically via JCEF. No jarring white boxes in a dark-theme IDE. Switch themes and the webview adapts instantly.

📦

Fully offline — Mermaid bundled

Mermaid 10.9.3 is packed inside the plugin zip. No CDN calls, no internet connection, no corporate firewall issues. Works on planes, trains, and air-gapped enterprise environments.

🎨

12+ diagram types

Flowchart, sequence, state machine, class, entity-relationship, Gantt, pie, git graph, user journey, mindmap, quadrant chart, timeline — the full Mermaid surface area supported out of the box.

🔁

Why does previewing a diagram take four steps?

You write a mermaid block, select all, copy, alt-tab to mermaid.live, paste, wait for it to render, squint at the result, alt-tab back, edit, and repeat. Every time. The IntelliJ Markdown plugin does not render mermaid fences — it just shows the raw text. Browser extensions help but they live outside your IDE.

Mermaid Preview puts the rendered diagram right next to your code, updates as you type, and never leaves your IDE. The copy-paste loop stops the moment you install it.

In action

See it for yourself

Real screenshots from IntelliJ IDEA with the plugin installed.

Stop alt-tabbing to mermaid.live

The preview you need is already in your IDE — you just had to install one plugin.

Feature
Mermaid Preview
mermaid.live
IntelliJ built-in
Browser ext
Lives inside your IDE
❌ Tab switch
Per-block toggle
Live-refresh as you type
❌ Manual
⚠️ Text only
⚠️
Works fully offline
All 12+ diagram types
⚠️
No copy-paste required
N/A
Under the hood

JCEF webview,
mermaid bundled inside

The plugin uses JCEF — the same Chromium-based webview JetBrains uses for its own DevTools. A DocumentListener fires on every keystroke, debounced to 250ms, calling MermaidBlockExtractor which parses the fences and sends a JSON payload to the embedded preview.html.

Mermaid 10.9.3 is bundled inside the plugin zip — no CDN, no network call, no corporate proxy to fight. The webview reads the IDE theme token and switches between dark and light mermaid themes automatically.

JCEF webviewDocumentListenerMermaid 10.9.3 bundledNo network requiredKotlinIntelliJ Platform SDK
diagram.md
```mermaid
sequenceDiagram
    Alice ->> Bob: Hello Bob
    Bob ->> Alice: Hi Alice
    Alice ->> Bob: Got a minute?
```

// ↑ type this in your .md file
// ↓ see this in the Mermaid panel
rendered sequence diagram appears
in the right sidebar instantly ✨
Installation

Up and running in 4 steps

Works in any JetBrains IDE — same steps everywhere.

1

Download the zip

Click the Download button below to get the latest zip from GitHub Releases.

2

Open plugin settings

In your JetBrains IDE: Settings → Plugins → ⚙ gear icon → Install Plugin from Disk…

Settings → Plugins → ⚙ → Install Plugin from Disk…

3

Select the zip and restart

Pick the downloaded zip, click OK, then restart the IDE when prompted.

4

Open any Markdown file

Open a .md file with ```mermaid fenced blocks — the Mermaid panel appears automatically on the right sidebar.

Supported IDEs

🧠IntelliJ IDEA
🐍PyCharm
🌐WebStorm
🐹GoLand
⚙️CLion
🎮Rider
🐘PhpStorm
🗄️DataGrip
🤖Android Studio

Any IDE built on the IntelliJ Platform 2023.3+ with JCEF enabled

Download v0.1.2

v0.1.2 · 2026-05-09 · MIT license · JetBrains IDEs 2023.3+

Past releases →
🛍️

Coming to JetBrains Marketplace

Roadmap v0.5

Right now you install from a zip file. That works fine, but the JetBrains Marketplace means one-click install directly from your IDE — no zip download, no manual steps, and automatic updates whenever a new version ships.

  • ✅ Install directly from Settings → Plugins → Marketplace
  • ✅ Automatic updates — always on the latest version
  • ✅ Listed in the official JetBrains plugin directory
Watch on GitHub →

Get notified on release

Stop alt-tabbing to mermaid.live

Free JetBrains plugin. Install in 4 steps. Works in every IntelliJ-based IDE.

Free forever · JetBrains IDEs 2023.3+ · MIT license

Past releases →