Mermaid Beauty

by theChildinus
5
4
3
2
1
Score: 31/100

Description

The Mermaid Beauty plugin restyles existing Mermaid blocks without requiring changes to diagram source. It provides coordinated colour palettes, single hue presets and custom colours that follow the current light or dark theme. Settings cover text size, connector width, corner shape, spacing and fit to width. Styling can share defaults across diagrams, use separate options by diagram type or retain native rendering. Supported formats include flowcharts, sequence diagrams, class diagrams, mind maps and charts. Explicit styles in source take precedence, while conflicting Mermaid renderer plugins should not run together. Rendering stays local, though externally linked images may require a network connection. The bundled renderer is about 5.9 MB, exceeds the 5 MB Obsidian Sync Standard limit and has not been tested on mobile devices.

Reviews

No reviews yet.

Stats

5
stars
2,606
downloads
1
forks
50
days
23
days
23
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
1
total issues
1
open issues
0
closed issues
17
commits

Latest Version

24 days ago

Changelog

Fix PDF and print exports that could enlarge a small fit-to-width Mermaid diagram to the full page width, including the behavior reported with Better Export PDF.

  • Preserve each rendered diagram's natural width in print and export contexts.
  • Continue shrinking diagrams that are wider than the printable page.
  • Leave Reading view and Live Preview sizing unchanged.

Validation: 202 unit tests, type checking, lint, production build, 80 browser renders, and 784 behavior checks passed. The fix was also checked in Obsidian 1.14.4 on macOS with built-in PDF exports at 100% and 46% scale. Better Export PDF was not installed in the validation vault, so confirmation with the reporter's exact plugin setup is still requested.

README file from

Github

Mermaid Beauty

Clearer Mermaid diagrams in Obsidian. Works with your existing mermaid blocks, without editing the source.

中文说明 · Feedback

The same release workflow before and after: native Mermaid scatters stages across the canvas with long cross-group paths; Mermaid Beauty aligns Checks, Validation, and Release from left to right and routes feedback below.

This release workflow is reorganized into Checks → Validation → Release, with equal-width cards in each layer, fewer connector bends, and feedback routed below the main flow. All 11 nodes and 16 connections are preserved.

Both use the same Mermaid source at the same scale: native Mermaid 11.13.0 with its default Dagre layout above, Mermaid Beauty with automatic ELK layout and the default Fresh palette below. No manual positioning or coloring. Click the image to enlarge.

Watch the 15-second before/after demo · Copy the three public examples

Long Chinese labels, a review loop, and grouped stages:

Chinese review workflow, before and after

A data pipeline with a retry path in dark mode:

Dark data pipeline, before and after

Each comparison keeps the source and display scale identical. The native baseline uses Mermaid 11.13.0 with Dagre; the dark example also uses its native dark theme.

Install

Requires Obsidian 1.12.7+. Open Settings → Community plugins → Browse, search for Mermaid Beauty, then install and enable it. Community listing

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Put all three files in <vault>/.obsidian/plugins/mermaid-beauty/.
  3. Reload Obsidian and enable Mermaid Beauty.

Your first diagram

Open a note that already contains a mermaid block, then switch to Reading view or move the cursor outside the block in Live Preview. You can also paste a public example into a new note.

If Obsidian asks to display Mermaid diagrams, allow it only if you trust the vault. The setting is Settings → Editor → Show Mermaid diagrams in notes. Mermaid Beauty leaves that permission under your control.

If the diagram still looks unchanged, run Mermaid Beauty: Refresh diagrams from the command palette. Check that enhanced rendering is enabled and that the diagram type is not set to Native. Source mode displays code; explicit source styling remains authoritative.

New installations show a one-time welcome notice. Open Getting started from the settings or command palette for setup and export guidance.

Adjust the appearance

Open Settings → Mermaid Beauty:

  • Colors: Fresh, Cool, and Natural coordinated palettes, single-hue presets, or custom colors. Follows Obsidian's light or dark theme.
  • Size and layout: adjust text size, connector width, corners, spacing, and fit-to-width.
  • Per diagram type: share defaults, use a separate style, or keep native rendering. Supports flowcharts, sequences, class diagrams, mind maps, charts, and more.

New installations use coordinated colors. Upgrades keep your existing appearance; choose Default appearance → Color style → Coordinated colors to try it.

Copy and export images

Use the Copy and export icon in the bottom-left corner of an enhanced diagram, or search the command palette for Mermaid Beauty: Copy diagram as SVG, Copy diagram as PNG, Export diagram as SVG, or Export diagram as PNG. The icon stays in place while the diagram scrolls, leaves the bottom-right corner for Mermaid Zoom, and takes no extra row. If the note contains multiple rendered diagrams, the command lets you choose one.

  • Copy SVG: copies a vector image with the current styles. Paste into an Obsidian note to save an SVG in that note's attachment folder and insert its image reference. Keep Beauty enabled between copying and pasting. Other apps must support SVG images; unsupported devices show a save-file suggestion.
  • Copy PNG: paste into documents, messages, or slides. If the device blocks clipboard images, use Export as PNG.
  • Export as SVG… / Export as PNG…: on desktop, choose a filename and location in the system save dialog. The first export starts in Obsidian's configured attachment folder; successful exports remember the chosen folder. The completion notice shows the location and a Show in folder button. Cancelling writes no image. Mobile exports still save to the configured attachment folder. Your note and Mermaid source stay unchanged.
  • Images retain the current light/dark appearance. PNG uses 2× resolution where possible, capped at 4,096 pixels per side and 16 million pixels to bound memory use. SVG retains vector geometry; text uses fonts available in the viewer.
  • Diagrams containing external image resources cannot be exported. The export does not fetch or upload those resources.

On touch screens the export button stays visible with a 44-pixel target. For dense diagrams, turn off Fit to width to keep text at its natural size and scroll horizontally.

Feedback

Found a problem or have an idea? Choose the matching issue form:

Search existing issues first. Include the plugin and Obsidian versions, platform, reproduction steps, and the smallest relevant public Mermaid example. Never post vault contents, proprietary diagrams, credentials, or other sensitive data.

Notes

  • Rendering runs locally. Diagram text is not uploaded; images linked in the source may need a network connection.
  • Explicit source styles take precedence. If another plugin also replaces Mermaid rendering, disable one of them if they conflict.
  • The bundled renderer is about 6 MB, above Obsidian Sync Standard's 5 MB file limit. Install separately on each device. Mobile devices have not been tested.

For cross-device setup and troubleshooting, see the usage guide. Browser checks include narrow layouts; they do not establish iOS or Android compatibility.

MIT License · Third-party notices

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Editing Toolbar
4 years ago by Cuman
An obsidian toolbar plugin, modified from the Cmenu plugin
Advanced Canvas
3 years ago by Developer-Mike
⚡ Supercharge your canvas experience! Graph view integration and unlimited styling options empower flowcharts, dynamic presentations, and interconnected knowledge.
Commander
5 months ago by jsmorabito
Commander - Obsidian Plugin | Add Commands to every part of Obsidian's user interface
Markmind
5 years ago by Mark
A mind map, outline for obsidian,It support mobile and desktop
Mermaid Tools
4 years ago by dartungar
Tools for improved Mermaid.js experience in Obsidian.md
Diagrams
5 years ago by Sam Greenhalgh
Draw.io plugin for obsidian.md
Heatmap Calendar
5 years ago by Richard Slettevoll
An Obsidian plugin for displaying data in a calendar similar to the github activity calendar
Map View
5 years ago by esm
Interactive map view for Obsidian.md
Dragger
5 months ago by ariestar
An Obsidian plugin for dragging and rearranging any block.
Extended Graph
2 years ago by Kapirklaa
Community plugin to add features to the graph view.
Excalidraw Extras
5 months ago by zsviczian
Companion Obsidian.md plugin hosting extra add-on optional features for the main Excalidraw-Obsidian plugin
Maps
a year ago by Obsidian
Map layout for Obsidian Bases. Display your notes as an interactive map view.
Beautitab
3 years ago by Andrew McGivery
A plugin for Obsidian.MD that creates a customizable new tab view with beautiful backgrounds, quotes, search, and more.
Contribution Graph
3 years ago by vran
generate interactive gitxxx style contribution graph for obsidian, use it to track your goals, habits, or anything else you want to track.
TikZJax
4 years ago by artisticat1
Render LaTeX and TikZ diagrams in your notes
draw.io
5 months ago by somesanity
A plugin for Obsidian that integrates the draw.io editor into Obsidian.
Heatmap Tracker
2 years ago by Maksim Rubanau
A customizable heatmap tracker plugin for Obsidian to visualize daily data trends with intuitive navigation and flexible settings.
Plugin Groups
4 years ago by Mocca101
A plugin that allows you to easily group and manage your other plugins in Obsidian.
Diagrams.Net
4 years ago by Jens M Gleditsch
This repository contains a plugin for Obsidian for inserting and editing diagrams.net (previously draw.io) diagrams.
Mehrmaid
3 years ago by huterguier
Rendering Obsidian Markdown inside Mermaid diagrams.
Note Gallery
3 years ago by Pash Shocky
A masonry note gallery for obsidian.
Smart Connections Visualizer
2 years ago by Evan Moscoso
Visualize your notes and see links to related content with AI embeddings. Use local models or 100+ via APIs like Claude, Gemini, ChatGPT & Llama 3
Wechat Converter
5 months ago by davidlam-oss
Obsidian 公众号排版(支持自定义 CSS和公众号贴图)、飞书云同步与多平台(小红书、知乎等)发布插件。Markdown 转微信文章 / Feishu docs / 知乎、小红书、今日头条等草稿,支持数学公式、本地图片、GIF 和 Mermaid。
Link Exploder
4 years ago by Ben Hughes
InfraNodus AI Graph View
2 years ago by Nodus Labs
Advanced graph view for Obsidian: text analysis, topic modeling, and AI with InfraNodus AI text analysis tool: https://infranodus.com
Enhanced Canvas
2 years ago by RobertttBS
When editing on Canvas, properties and Markdown links to notes are automatically updated, enabling backlinks in Canvas.
Desmos
5 years ago by Nigecat
Embed graphs directly into your obsidian notes
Optimize Canvas Connections
4 years ago by Félix Chénier
An Obsidian plugin that declutters a canvas by reconnecting notes using their nearest edges
New 3D Graph
a year ago by Aryan Gupta
Visualize your vault in 3D with a powerful, highly customizable, and filterable graph.
Unicode Search
4 years ago by BambusControl
Simple Unicode character search for Obsidian.md
Graph Banner
2 years ago by ras0q
An Obsidian plugin to display a relation graph view on the note header.
Mermaid Popup
2 years ago by ChenPengyuan
Simple Columns
a year ago by Josie
An Obsidian plugin that lets you create easily resizable and customizable columns in your notes.
Emoji Magic
4 years ago by simplgy
Makes it easier to add emojis using an improved keyword search
Show Whitespace
3 years ago by Erin Schnabel
Show leading/trailing whitespace
Simple Banner
a year ago by Sandro Ducceschi
Visually enhance your Obsidian notes with a customizable banner. Supports icons and time/date display.
Mindmap
3 years ago by YunXiaoYi
An Obsidian plugin for creating Mindmaps.
Natural Language Syntax Highlighting
4 years ago by artisticat
Highlight adjectives, nouns, adverbs, verbs, and conjunctions in Obsidian.md
D2
4 years ago by Terrastruct
The official D2 plugin for Obsidian. D2 is a modern diagram scripting language thats turns text to diagrams.
Habit Tracker
5 years ago by duo
This plguin for Obsidian creates a simple month view for visualizing your punch records.
Galaxy View
4 months ago by Rick
Canvas Links
3 years ago by aqav
Show the links between "Canvas" and "File"
Mermaid Themes
3 years ago by jvsteiner
mermaid themes for obsidian
Canvas Filter
4 years ago by Ivan Koshelev
Obsidian Canvas plugin that let's you show only pages / arrows with specific tags / colors / connections.
Advanced Progress Bars
2 years ago by cactuzhead
Obsidian plugin to create custom progress bars
CardNote
3 years ago by cycsd
Help you extract your thoughts more quickly in canvas
Mermaid Zoom
3 months ago by xiaozhuang0433
A plugin that adds zoom functionality to Mermaid charts in Obsidian.
Tasks Map
a year ago by NicoKNL
A graph view of your tasks.
Graph Link Types
3 years ago by natefrisch01
Link types for Obsidian graph view.
Callout Integrator
4 years ago by
A plugin for Obsidian to allow the integration of long blocks of text into callouts.
Chessboard Viewer
6 years ago by Davide Aversa
Plugin to render chessboards in Obsidian using chessboardjs
Kroki
5 years ago by Greg Zuro
Neo4j Graph View
6 years ago by Emile van Krieken
Custom Classes
4 years ago by Lila Rest
A minimal Obsidian plugin that allows you to add your own HTML classes to chosen Markdown elements directly from your notes.
Export Graph View
2 years ago by Sean McGhee
Plugin to export your vault's graph view.
Canvas Mindmap Helper
3 years ago by Tim Smart
Nomnoml Diagram
5 years ago by Daeik Kim
Obsidian Plugin for nomnoml diagram
Release Timeline
4 years ago by cakechaser
Habit Tracker
4 years ago by David Moeller
A Plugin to display a Habit Tracker in Obsidian.
Nifty Links
3 years ago by x-Ai
Generating elegant, Notion-styled rich link cards to enhance your note-taking experience.
Arrows
3 years ago by artisticat
Draw arrows across different parts of your notes, similar to on paper
Argument Map with Argdown
5 years ago by amdecker
MoreDraw
2 years ago by webceoboy2011
mordraw.com for obsidian plugin
Dirtreeist
4 years ago by kasahala
Render a directory Structure Diagram from a markdown lists in codeblock.
Metadata Icon
3 years ago by Benature
change metadata entry icon
Content Cards
2 years ago by leo
Insert content cards in Markdown, such as timeline, highlightblock, target card, book information card, music information card, movie information card, photoes ablum, business card, content subfield, countdown, SWOT,BCG.
WaveDrom
5 years ago by Alex Stewart
Custom Theme Studio
a year ago by @gapmiss
An Obsidian.md plugin to create and tweak custom themes with live CSS editing, element styling, and instant previews. All without leaving Obsidian.
Node Factor
2 years ago by CalfMoon
Customize factors effecting node size in obsidian graph.
Adamantine Pick
4 years ago by Urist McMiner
Embeddable Pikchr(https://pikchr.org) diagrams renderer plugin for Obsidian(https://obsidian.md)
Chemical Structure Renderer
3 years ago by xaya1001
Render chemical structures from SMILES strings into PNG or SVG format using Ketcher and Indigo Service.
Root Folder Context Menu
3 years ago by mnaoumov
Obsidian Plugin that enables context menu for vault root folder
YourPulse - Your Writing Activity Visualised
2 years ago by Jiri Sifalda
YourPulse.cc - Obsidian.md plugin that turns your vault into a reflection of your creativity, and put your writing on steroids 💪
Mermaid Icons
9 months ago by toshs
Obsidian plugin enabling the use of icons in Mermaid diagrams.
Text Wrapper
4 years ago by smx0
Plugin for Obsidian
Inline Local Graph
9 months ago by TKOxff
Inline Local Graph of Obsidian
Extended File Support
2 years ago by Nick de Bruin
Adds opening and embedding support for various filetypes to Obsidian
Pixel Pets
a year ago by Lucas Jin
Adds cute pixel pets to Obsidian.
Custom Slides
a year ago by David V. Kimball
Customize Obsidian's Slides core plugin's navigation, styles, and behavior.
Weather Widget
10 months ago by mr-asa
Weather widget for display in notes, Canvas, and a separate tab.
Mapbox Location Image
3 years ago by Aaron Czichon
Render a mapbox location image based on provided coordinates
Desk
3 years ago by David Landry
A desk for obsidian
Lilypond
3 years ago by DOT-ASTERISK
Lilypond for Obsidian
Easy Timeline
2 years ago by Romeliun
The Easy Timeline plugin for Obsidian allows you to create timelines easily.
Generate Timeline
2 years ago by Shanshuimei
An obsidian plugin to generate timelines from tags, folders, files or metadata automatically. 根据标签,文件夹,文件或者属性自动生成时间轴的插件。
Flowcharts
2 years ago by land0r
Flowchart Plugin for Obsidian – Create and customize flowcharts seamlessly within your Obsidian vault. Powered by Flowchart.js and designed for productivity
Tier List
2 years ago by Mox Alehin
Obsidian plugin for visual ranking and organizing content into customizable Tier Lists.
Laws of Form
3 years ago by Kevin German
Home Pages
2 months ago by jepicaju862-lab
Customizable homepage dashboard for Obsidian
Canvas Daily Note
3 years ago by Andrew McGivery
A plugin for Obsidian that allows you to add a daily note node to the canvas that will always show todays note.
Markline
3 years ago by 闲耘
Markline: Markdown timeline view in Obsidian.
Lineup Builder
5 years ago by James Fallon
An Obsidian plugin that lets you build football lineups
ASCII Tree Generator
2 years ago by Matěj Michálek
Folder Canvas
2 years ago by Nancy Lee
Generate a canvas view of your folder structure
Better Order List
3 years ago by Boninall
Storyclock Viewer
3 years ago by Jonathan Fisher
Obsidian plugin for creating a storyclock
Set View Mode per Note
3 years ago by Alex Davies
Use YAML frontmatter to specify a view mode per note.
BattleSnake Board Viewer
3 years ago by EnderInvader
Plugin to render battlesnake boards in Obsidian
Mathematica Plot
3 years ago by Marcos Nicolau
Insert functions on Obsidian using Wolfram Mathematica!
Tabsdown
4 months ago by grafanakibana
Create accessible, theme-native tabbed blocks for Markdown-renderable content in Obsidian.
Tag Formatter
3 years ago by snsvrno
Configurable Obsidian plugin that hides parent tags.
MantouAI
3 years ago by Morino Pan
MantouAI—— 让Obsidian变身智能助手
Canvas Explorer
2 years ago by Henri Jamet
A plugin that enables users to explore their vault by iteratively adding or ignoring linked notes, ultimately generating a customizable canvas that visually represents the preserved notes and their connections.
Life in Weeks Calendar
a year ago by Jeff Szuc
Plugin for the Obsidian markdown editor. Displays a calendar of your life in weeks with weekly Periodic Notes plugin integration. Includes options for the traditional Memento Mori/Stoic style calendar, as well as a Gregorian calendar accurate version.
Timelive
a year ago by aNNiMON
Turn a list of dates into a timeline
Alfonso Money Manager
3 years ago by SmartLifeGPT Innovation
This is the repository for the obsidian plugin of the Alfonso Money Manager mobile application
Waveform Player
2 years ago by Zhou Hua
NodeFlow
2 years ago by LincZero
Render node streams like `ComfyUi`, `UE`, `Houdini`, `Blender`, etc., to make it easy to write relevant notes. json describes the chart, compared to screenshots, making it easier to modify later. The plugin is also compatible with blogs.",
Kale Graph
2 years ago by Oli
Render mathematical graphs in Obsidian
List Callouts Improved
2 months ago by Daniel Yim
Create callouts in lists in Obsidian.
Sankey
2 years ago by Finn Romaneessen
An Obsidian plugin to create sankey diagrams
Magic Move
2 years ago by imfenghuang
Animating Code Blocks in Obsidian
Prism
a month ago by floorianmb
Prism: sandboxed, themed, interactive visualizations in Obsidian notes
Visited Countries
a year ago by Ivan Peshykov
Obsidian plugin to mark and visualize the countries you've visited on an interactive world map.
Mapa neuronal
2 months ago by Felipe Córdova
A graph that explains itself: your Obsidian vault as a layered neural map, with the reason each note links to the next.
Mahgen Renderer
2 years ago by Michael Francis Williams
Obsidian plugin to render mahgen automatically
Every Day Calendar
2 years ago by QuBe
Obsidian plugin to create calendars inspired by Simone Giertz's Every Day Calendar
NyanBar
2 years ago by xhyabunny
Give life to your Obsidian notes with NyanBar !
My SVGs
10 months ago by Omar Badawy
An Obsidian plugin that Registers your own SVGs into Obsidian's global icon library for use with other plugins or however you want.
Boardgame Search
2 years ago by Marlon May
A plugin to create notes for boardgames based on the BGG API
GLSL Viewer
9 months ago by iY0Yi
Preview GLSL shaders on Obsidian.
Cool Bases
a month ago by pattgue
Design cool card views for Obsidian Bases.
Inline TikZ
3 months ago by Lachlan Harris
Render seamless Tikz, CircuiTikz & other PGFPlots LaTeX diagrams directly in your notes.
Pintora
2 years ago by Amias Lee
Create Pintora diagrams directly in the Obsidian.
Poker Range
2 years ago by marplek
Easily create, view, and interact with poker hand ranges in your obsidian.
ShaahMaat-md
2 years ago by Mihail Kovachev
InventExplorer
22 days ago by solidinvent
Add file and folder icons, colors and text styles to the file explorer. Lucide, Tabler, Boxicons, Phosphor and emoji icons, with regex rules that style many paths at once.
Class Relation Visualization
2 years ago by Yong
D2 Standalone
19 days ago by m-haruki
Render D2 diagrams in Obsidian without installing D2 — fully standalone, cross-platform. Unofficial, not affiliated with Terrastruct.
GoBoard
10 months ago by Dmitry I. Sokolov
Obsidian plugin for rendering Go game diagrams from markdown code blocks
Mahjong Renderer
2 years ago by hypersphere
Chronobars
2 months ago by Daniel Hidefjäll
Create time-based progress bars in Obsidian
Mermaid Link Navigator
2 months ago by w-java123
ICOR for Life - Interface
3 months ago by Paperless Movement S.L.
The vault's chrome in one place: hide the ribbon and Obsidian's own controls, and give any folder a colour, an icon and a label. Writes no CSS; the INKLINE theme draws it. Part of the ICOR for Life suite.