Obsidian Stats logoObsidian Stats

Mermaid Next

by Nasser Alansari
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Renders Mermaid diagrams using the latest version, independent of the built-in bundled version.

Reviews

No reviews yet.

Stats

stars
8
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Mermaid Next (obsidian plugin)

License: MIT Obsidian

Renders Mermaid diagrams using the latest version, independent of the built-in bundled version.

An Obsidian plugin that registers a mermaid-next code block and renders it with a current build of Mermaid, sourced either from a bundled copy or from the jsDelivr CDN.

Table of Contents

Background

Obsidian bundles its own copy of Mermaid that lags behind upstream releases. New diagram types, syntax improvements, and bug fixes added to Mermaid aren't available in Obsidian until the next app update — which can take months.

This plugin loads Mermaid independently of Obsidian, so new diagram features are usable as soon as Mermaid ships them.

Install

Community plugin store

Search for Mermaid Next in Settings → Community plugins, then enable it.

Manual

Copy main.js, styles.css, and manifest.json into your vault at .obsidian/plugins/mermaid-next/, then enable the plugin in Settings → Community plugins.

Dependencies

None for end users — the bundled copy of Mermaid ships inside main.js. For development, see Contributing.

Usage

Use mermaid-next as the code block language:

```mermaid-next
sequenceDiagram
    participant Alice@{ type: "queue" }
    participant Bob
    Alice->>Bob: Queue message
    Bob->>Alice: Queue response
```

Any valid Mermaid syntax works — flowcharts, sequence diagrams, class diagrams, mindmaps, and more.

Settings

Changes apply on the next render — no plugin reload required.

Setting Default Description
Source Bundled Bundled uses the copy shipped with the plugin (offline, fixed version). CDN loads from jsDelivr.
Version latest CDN only. Use latest or pin a specific version like 11.15.0.
CDN cache empty Manual Download button caches the selected CDN version locally for offline use. Clear cache removes it.
Obsidian theme integration on When enabled, diagrams follow the active Obsidian theme. When disabled, Mermaid uses its default theme.
ELK layout engine on Uses ELK as the default layout engine. Produces better results for complex flowcharts.
Hand-drawn look off Renders diagrams with a sketched, hand-drawn style.
Replace Obsidian's Mermaid off Swaps window.mermaid so all built-in ```mermaid``` blocks across Obsidian also use this plugin's version. May conflict with other plugins that modify Mermaid.

Scope

This plugin's core job: render mermaid-next code blocks with a current version of Mermaid. An opt-in setting extends that coverage to plain mermaid blocks too (see Settings). No further features are planned. This narrow scope is intentional — low maintenance, long-term stability.

Maintainer

Contributing

Questions and bug reports: open an issue on GitHub.

Bug fix PRs are welcome. Feature PRs that expand scope beyond rendering mermaid-next blocks are unlikely to be merged — see Scope.

Development:

bun install
bun run dev    # watch build
bun run build  # production build + typecheck
bun run lint

No sign-off or CLA required.

License

MIT © Nasser Alansari

Sponsors