DiagramForge.Tool 1.1.0

DiagramForge

Text in, SVG out. DiagramForge is a .NET library and CLI for rendering diagram text to real SVG without a browser, JavaScript runtime, or headless Chrome.

DiagramForge focuses on the cases where Mermaid-style diagram authoring is useful, but browser-generated SVG is not: PowerPoint decks, Keynote slides, Inkscape workflows, docs pipelines, and image conversion with tools like librsvg.

Why DiagramForge

• Real SVG output with native text elements
• No browser, Node.js, or headless Chrome dependency
• Deterministic rendering suitable for snapshot testing
• Mermaid subset support plus presentation-oriented conceptual layouts
• Built-in themes, JSON themes, palette overrides, and embedded frontmatter styling

Install

DiagramForge targets .NET 10.

Library

dotnet add package DiagramForge

CLI (dnx)

dnx DiagramForge.Tool --help

With .NET 10, dnx can run the tool package directly without a prior install.

Basic usage

using DiagramForge;

var renderer = new DiagramRenderer();
string svg = renderer.Render("""
flowchart LR
  A[Plan] --> B[Build]
  B --> C[Ship]
""");

CLI usage

dnx DiagramForge.Tool diagram.mmd -o diagram.svg
dnx DiagramForge.Tool diagram.mmd --theme dracula --transparent -o overlay.svg

Supported today

• Mermaid subset: flowchart, block, sequence, state, mindmap, timeline, venn, architecture, and xychart
• Conceptual DSL: matrix, pyramid, cycle, pillars, funnel, and radial
• Theme presets, theme JSON files, palette overrides, and frontmatter styling

DiagramForge intentionally implements a focused Mermaid subset rather than full Mermaid.js parity.

Documentation

• Full project README: github.com/jongalloway/DiagramForge
• Theming guide: Theming
• Frontmatter guide: Frontmatter
• Product scope and roadmap: PRD

Feedback

• Issues: github.com/jongalloway/DiagramForge/issues
• Source: github.com/jongalloway/DiagramForge