Welcome to Diagrammo

Diagrammo is a diagram editor for creating charts and diagrams with a simple plain-text syntax. Write a few lines of text — get a polished, theme-aware diagram. Available as a desktop app and online editor.

Learn more at diagrammo.app.

DGMO and Diagrammo

DGMO is the plain-text markup language you write. Diagrammo is the app you write it in.

Think of it like Markdown and your editor — Markdown is the syntax, and you can write it anywhere. DGMO works the same way: it’s a .dgmo text file that describes a diagram. You can create and edit .dgmo files in the Diagrammo desktop app, the online editor, Obsidian (via plugin), or any text editor. The dgmo CLI renders them from the terminal, and the @diagrammo/dgmo npm package lets you render them programmatically.

The name “DGMO” is shorthand for “Diagrammo” — shorter to type, easier to use as a file extension and command name.

Getting Started

  • Create a new file using the file tree on the left, or press Cmd + N
  • Write diagram code in the editor — the preview updates in real time
  • Export your diagrams as PNG or SVG
  • Browse the sidebar to explore all chart types and features

Every diagram starts with the chart type on the first line, followed by your data and options. For example:

bar Q1 Sales

Jan 42
Feb 58
Mar 71

The Diagrammo Ecosystem

Desktop App

A native Mac app for authoring .dgmo files with a live preview editor, file tree, and export. Download at diagrammo.app/app.

Online Editor

The full Diagrammo experience in your browser at online.diagrammo.app. Your diagrams are stored in your browser’s Origin Private File System (OPFS) — they persist across sessions, but clearing browser data will remove them.

CLI Tool

The dgmo command-line tool renders .dgmo files to PNG or SVG from your terminal. Install it via Homebrew:

brew tap diagrammo/dgmo
brew install dgmo

Or run directly with npx:

npx @diagrammo/dgmo diagram.dgmo

JavaScript / TypeScript Library

The @diagrammo/dgmo npm package lets you parse and render diagrams programmatically — useful for generating diagrams in build pipelines, servers, or web apps.

npm install @diagrammo/dgmo