Skip to content

0.8.0-alpha.3 - 2026-07-09

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Jul 06:11
v0.8.0-alpha.3
56227a5

Release Notes

0.8.0-alpha.3 turns Merman into a local Mermaid authoring tool, not only a renderer. You can lint from the CLI, talk to editors through LSP, call analysis APIs from browsers, and try the whole path in the new VS Code extension. ASCII output also covers more diagrams for terminals, docs, and text-only previews.

Highlights

  • You can now lint and edit Mermaid locally. The new analysis and LSP stack covers diagnostics, completions, hover, symbols, references, rename, folding, semantic tokens, and quick fixes. #20
  • The new VS Code extension includes preview, diagnostics, source actions, snippets, SVG/PNG export, copy actions, and bundled merman-lsp / merman-cli binaries per platform. #20
  • ASCII output is much more useful: state diagrams, sequence boxes and notes, class/ER relations, relation summaries, XYChart legends, extra Flowchart shapes, capability grades, and tighter dense layout fallbacks. #13 #17
  • Web users can pick smaller package surfaces. @mermanjs/web now has capability-specific subpaths and metadata for render, ASCII, ELK, analysis, and editor-language builds. #20

New crates

  • merman-analysis is the render-free analysis layer. Use it when you want diagnostics, lint metadata, Markdown/MDX fence handling, or source ranges without pulling in SVG rendering. #20
  • merman-editor-core contains editor behavior that is not tied to any protocol: completions, hover data, symbols, rename/navigation helpers, and semantic token inputs. #20
  • merman-lsp packages the editor stack as a language server for VS Code and other LSP clients. #20

Breaking changes

  • merman-cli only loads icon packs from the network with --allow-network. Local node_modules, local JSON files, and file:// icon packs still work by default. #19
  • merman-cli keeps stdout for requested output bytes. Progress and non-error diagnostics go to stderr. #19
  • merman-cli now uses exit code 2 for invalid input/config/output, 3 for direct I/O failures, and 1 for render/runtime failures. Broken stdout pipes exit successfully. #19
  • merman-core::Error::DiagramParse now stores diagnostic: ParseDiagnostic instead of a top-level message. Rust callers should use diagnostic.message() for display text and diagnostic.span() / diagnostic.span_kind() when they need source locations. #20
  • Slim @mermanjs/web subpaths now leave out unsupported runtime wrappers instead of exporting stubs that throw. Use the default entry point or @mermanjs/web/full when one import needs render, ASCII, and editor-language APIs together. #20
  • The optional merman egui-example feature and desktop GUI example are gone. #19

New and changed

  • VS Code preview, diagnostics, source actions, and language intelligence can be turned on independently, so it is easier to run Merman next to other Mermaid tools. #20
  • Python UniFFI ABI 2 adds reusable engines, diagram-family capability discovery, and host text-measurement callbacks. #20
  • merman-cli --svg-pipeline parity|readable|resvg-safe lets CLI users ask for export-safe SVG bytes directly. #19

Fixes and polish

  • VS Code preview keeps the right source more reliably when Markdown files have multiple Mermaid fences, previews are locked, renders go stale, or users copy/export output. #20
  • LSP diagnostics and semantic tokens no longer publish stale results after newer document edits. #20
  • ASCII routing and fallback output are cleaner for nested subgraphs, relation labels, wide terminal cells, tight grids, and playground examples. #13 #15 #16 #17
  • resvg-safe SVG output can remove duplicate native/fallback labels after raster-safe fallback generation. #19
  • The quick-xml RustSec audit failure is gone after removing the stale GUI dependency path. #11

merman-cli 0.8.0-alpha.3

Install merman-cli 0.8.0-alpha.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Latias94/merman/releases/download/v0.8.0-alpha.3/merman-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/Latias94/merman/releases/download/v0.8.0-alpha.3/merman-cli-installer.ps1 | iex"

Download merman-cli 0.8.0-alpha.3

File Platform Checksum
merman-cli-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
merman-cli-x86_64-apple-darwin.tar.xz Intel macOS checksum
merman-cli-x86_64-pc-windows-msvc.zip x64 Windows checksum
merman-cli-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum

merman-lsp 0.8.0-alpha.3

Install merman-lsp 0.8.0-alpha.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Latias94/merman/releases/download/v0.8.0-alpha.3/merman-lsp-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/Latias94/merman/releases/download/v0.8.0-alpha.3/merman-lsp-installer.ps1 | iex"

Download merman-lsp 0.8.0-alpha.3

File Platform Checksum
merman-lsp-aarch64-apple-darwin.tar.xz Apple Silicon macOS checksum
merman-lsp-x86_64-apple-darwin.tar.xz Intel macOS checksum
merman-lsp-x86_64-pc-windows-msvc.zip x64 Windows checksum
merman-lsp-x86_64-unknown-linux-gnu.tar.xz x64 Linux checksum
Assets 32
Loading