README file from
GithubBeautiful Mermaid Renderer for Obsidian
An Obsidian plugin that renders Mermaid diagrams with beautiful-mermaid SVG output and Obsidian theme variables.
Inspired by Craft's Beautiful Mermaid gallery and powered by lukilabs/beautiful-mermaid.
Usage
Use a mermaid code block:
```mermaid
graph LR
A[API emitEvent] --> B[Fanout exchange]
B --> C[Gateway session A]
B --> D[Gateway session B]
```
Aliases are supported:
mermaidmermaid-beautifulbeautiful-mermaidbmmd
Build
bun install
bun run build
Install Into A Vault
Copy these files into:
<vault>/.obsidian/plugins/beautiful-mermaid-renderer/
Required files:
manifest.jsonmain.jsstyles.css
Enable Beautiful Mermaid Renderer from Obsidian settings.
Reading view and Live Preview are both supported. In Live Preview, move the cursor outside the code block to see the rendered diagram; use the hover Edit button to reveal the source again.
Inline diagrams fit to the editor width by default so the whole diagram is visible. Disable Fit diagrams to width in plugin settings to use readable-height scaling with horizontal scrolling.
Preview
The preview SVGs are generated locally from Mermaid source:
bun run assets
Release Files
Manual install needs:
main.jsmanifest.jsonstyles.css
Development
bun run dev