Advanced Mermaid

by indubyagee
5
4
3
2
1
Score: 50/100

Description

Render Mermaid-compatible diagrams locally with Pele 1.12.0 in Obsidian. Advanced Mermaid provides inline editing, theme-aware styles, reusable preset classes, and SVG/PNG/Canvas export.

Reviews

No reviews yet.

Stats

0
stars
94
downloads
0
forks
12
days
1
days
1
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
13
commits

Latest Version

2 days ago

Changelog

Added

  • Export rendered Flowcharts and Agentflows to new .canvas files with editable text cards, nested groups, and labeled connections.
  • Reuse the vault folder picker, handle filename collisions, and offer to open the saved canvas in a new tab.
  • Export Agentflow refdoc nodes and Flowchart document shapes as Canvas file cards backed by Markdown notes beside the canvas.
  • Reserve filenames across concurrent exports and reuse notes when retrying a partial save in the same dialog.

Changed

  • Remove !important overrides using scoped styles for diagram controls, the Live Editor, and export snapshots.
  • Advanced Mermaid now manages the zoom buttons, and Pele handles zoom and pan.
  • Use yaml to parse and serialize frontmatter in tests.

Fixed

  • Keep Canvas save dialogs usable when Obsidian refreshes the diagram’s appearance.
  • Keep the configured source font and sticky line numbers when moving the Live Editor to a pop-out window, including with the Minimal theme.
  • Create editor widgets and PNG export canvases in their owning windows using Obsidian's DOM helpers.
  • Clear a lint false positive on the style.global settings declaration.

Full Changelog: https://github.com/indubyagee/advanced-mermaid/compare/0.3.1...0.3.2

README file from

Github

Advanced Mermaid

Latest release GitHub stars MIT license Obsidian downloads Support on Ko-fi Support on Buy Me a Coffee

Edit a Mermaid diagram and see it update in the same Obsidian note. Advanced Mermaid lets you match diagrams to the vault theme, reuse styles and presets across notes, export diagrams as SVG or PNG, and turn Flowchart and Agentflow diagrams into editable Obsidian Canvases.

```mermaid
flowchart TD
    A["Write Mermaid"] --> B["Preview diagram"]
    B --> C{"Ready to share?"}
    C -->|Not yet| D["Edit in place"]
    D -.-> B
    C -->|Yes| E["Export SVG or PNG"]
```

Live editor

Requires Obsidian 1.14.5 or later on desktop.

Installation

  1. In Obsidian, open Settings → Community plugins. If prompted, select Turn on community plugins.
  2. Select Browse and search for Advanced Mermaid.
  3. Select Install, then Enable.

View the Obsidian plugin listing · Install manually from GitHub

Try a diagram

Copy this block, including the backticks, into a blank note.

```mermaid
flowchart LR
    A[Draft] --> B[Review]
    B --> C[Publish]
```

In Live Preview, add a blank line after the block and move the cursor there to see the flowchart. Select Live editor above the diagram and change Draft to Plan in the source. The preview updates as you type. You can also view the diagram in Reading view.

While the plugin is enabled, it renders both mermaid and pele code blocks using Pele, a Mermaid-compatible renderer. Some diagrams may look different because Pele handles layout and styling in its own way. Pele compatibility

Documentation

  • User Guide for editing, styling, exporting, and troubleshooting.
  • Technical reference for configuration syntax, rendering behavior, and development.
  • Contributing for reporting issues, testing changes, and opening pull requests.
  • Changelog for release notes.

License and credits

Advanced Mermaid and its bundled renderer, Pele, use the MIT license. Project license · Pele source

Support the project on Ko-fi or Buy Me a Coffee.