Diagrammo Diagrams

Render Diagrammo diagrams inline in your Obsidian notes using ```dgmo code fences. Works on desktop and mobile.

Supported chart types

All chart types from @diagrammo/dgmo are supported:

Mermaid-backed chart types (quadrant via Mermaid) are not yet supported in the plugin.

Usage

Write a fenced code block with the dgmo language tag:

```dgmo
bar Quarterly Revenue
x-label Quarter
y-label Revenue ($M)

Q1 4.2
Q2 4.8
Q3 5.1
Q4 5.9
```

The diagram renders inline in reading mode and live preview.

Example note

Open the command palette (Cmd/Ctrl + P) and run:

Diagrammo Diagrams: Create example note with all chart types

This creates a Diagrammo Examples.md file in your vault with working examples of every supported chart type.

Settings

Install

From Obsidian Community Plugins

1. Open Settings > Community Plugins > Browse
2. Search for "Diagrammo Diagrams"
3. Click Install, then Enable

Manual install

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create a folder: <vault>/.obsidian/plugins/dgmo/
3. Copy the three files into that folder
4. Enable the plugin in Settings > Community Plugins

Development

Prerequisites

• Node.js 18+

Setup

npm install

Commands

npm run build     # One-shot build → main.js (esbuild, CJS bundle)
npm run dev       # Watch mode (rebuilds on save, inline sourcemaps)

The build bundles everything (including @diagrammo/dgmo and echarts) into a single main.js in the repo root, which Obsidian loads directly. obsidian, electron, and CodeMirror packages are externalized.

Project structure

src/
├── main.ts       # Plugin lifecycle, markdown post-processor, example note command
├── render.ts     # Rendering dispatcher (routes to ECharts or D3 based on chart type)
├── settings.ts   # Settings tab UI (palette dropdown, theme, chart height)
└── examples.ts   # Example note content with all chart types

Dependencies

• @diagrammo/dgmo ^0.8.19 — diagram parsing and rendering (bundled by esbuild)
• echarts ^6.0.0 — chart rendering for ECharts-backed types
• obsidian ^1.12.3 — Obsidian plugin API (dev only, externalized)

Testing locally

1. Run npm run dev (watch mode)
2. Symlink or copy the repo into your vault's .obsidian/plugins/dgmo/ folder
3. Enable the plugin in Obsidian settings
4. Edit a note with a ```dgmo code fence — changes rebuild automatically

Releasing

GitHub release

1. Bump version in both package.json and manifest.json (must match)
2. Build: npm run build
3. Commit and push
4. Create a GitHub release with tag <version> (e.g., 1.0.1)
5. Attach these files to the release:
   • main.js
   • manifest.json
   • styles.css

Obsidian Community Plugins

The plugin is listed in the Obsidian Community Plugins registry. New versions are picked up automatically from GitHub releases — just publish a new release with the required files attached.

Links

• diagrammo.app — full desktop editor
• @diagrammo/dgmo — the dgmo markup library and CLI
• dgmo syntax reference

License

MIT