One diagram language, everywhere

The same .dgmo markup works across a desktop app, CLI, npm library, AI agents, browser, and Obsidian. Pick the surface that fits your workflow.

Desktop

Diagrammo App

macOS 12+

The primary authoring experience. Split-pane editor with live preview, 8 color palettes, Vim mode, and export to PNG, SVG, PDF, or HTML. Built with Tauri — fast, native, lightweight.

Download from diagrammo.app/app

Best for: Writing and iterating on diagrams daily

Terminal

DGMO CLI

macOS / Linux / Windows

Render .dgmo files to PNG or SVG from the command line. Fits into scripts, CI pipelines, Makefiles, and git hooks. Same rendering engine as the desktop app.

brew install diagrammo/dgmo/dgmo

Best for: CI/CD pipelines, automation, batch rendering

npm

@diagrammo/dgmo

MIT License

Open-source JavaScript/TypeScript library. Parse DGMO source and render SVGs programmatically. Embed diagram rendering in your own tools, dashboards, or documentation systems.

npm install @diagrammo/dgmo

Best for: Building tools, embedding diagrams, custom integrations

MCP Server

Claude / MCP clients

Give Claude and other AI assistants the ability to create diagrams. Describe what you want in plain English — the AI picks the right chart type, writes the markup, and renders it.

npx -y @diagrammo/dgmo-mcp

Best for: AI-assisted diagram creation, project analysis

Browser

Playground

Free / No install

Free online diagram editor — no sign-up, no install. Write text and export diagrams instantly. Share diagrams via URL. Runs entirely in your browser.

diagrammo.app/playground

Best for: Quick diagrams, sharing with teammates, trying DGMO

Plugin

Obsidian Plugin

Obsidian

Render dgmo code blocks as live diagrams inside Obsidian notes. Your notes stay portable — it's just text. Supports all 29 diagram types and 8 palettes.

Install from Community Plugins

Best for: Documentation-as-notes, knowledge bases, PKM

Which should I use?

Pick the tool that fits what you're doing. They all use the same diagram language.

Writing diagrams daily Desktop App — Full editor with live preview, Vim mode, file management, and export Rendering in CI or scripts DGMO CLI — Pipe .dgmo files through dgmo and get PNG/SVG output Building a tool or dashboard npm Library — Import @diagrammo/dgmo and render SVGs programmatically Using AI to create diagrams MCP Server — Claude and other AI assistants can render diagrams directly Quick diagram, no install Playground — Free browser editor — works immediately, shareable via URL Diagrams in Obsidian notes Obsidian Plugin — Render dgmo code blocks as live diagrams in your vault

The DGMO format

DGMO is a plain-text markup language for diagrams. It's human-readable, version-control friendly, and designed to be written quickly. The same .dgmo file renders identically everywhere — desktop, CLI, browser, AI, and Obsidian.

Example

chart: sequence
title: API Request

Client -GET /users-> Server
  Server -SELECT * FROM users-> DB
  DB -rows-> Server
Server -200 OK-> Client

29 diagram types

barlinepiearearadarscatterheatmapfunnelsankeychordslopewordcloudtimelinevennquadrantsequenceflowchartclasserorgkanbanc4arcfunctiondoughnutpolar-areabar-stackedmulti-lineinitiative-status