Skip to content

v0.1.0

Release Date: 2026-03-07

Initial release of d2vision - a comprehensive toolkit for D2 diagram parsing, generation, and AI-assisted creation.

Highlights

  • Complete toolkit for working with D2 diagrams programmatically
  • TOON output format (default) uses ~40% fewer tokens than JSON - ideal for LLM consumption
  • Embedded D2 rendering engine - no separate D2 CLI installation required
  • Mermaid and PlantUML conversion support

Features

Core Library

  • SVG Parser: Extract structure from D2-generated SVGs by decoding base64-encoded element IDs
  • Diagram Types: Node, Edge, Bounds, Shape types with full styling support
  • NLP Descriptions: Natural language generation for diagram descriptions (Describe(), DescribeSummary(), DescribeDetailed())
  • Layout Analysis: Detect layout patterns (flow, hierarchical, grid) and provide generation hints

Output Formats

  • TOON (default): Token-Oriented Object Notation for LLM efficiency
  • JSON: Standard and compact formats
  • YAML: YAML serialization

Code Generation

  • DiagramSpec: Generate D2 code from structured specifications
  • PipelineSpec: Workflow diagrams with stages, executors, swimlanes, and decision branches
  • Templates: 7 built-in patterns (network-boundary, microservices, data-flow, sequence, entity-relationship, deployment, pipeline)

Converters

  • Mermaid: Flowchart, sequence, and class diagram conversion
  • PlantUML: Sequence, class, and component diagram conversion

CLI Commands

Command Description
parse Extract structure from D2-generated SVG
generate Create D2 code from specifications
template Generate diagram templates for common patterns
learn Reverse engineer D2 from existing SVG
lint Check D2 files for layout issues
diff Compare two diagrams
watch Auto-render D2 files on changes
analyze Analyze layout characteristics
convert Convert Mermaid/PlantUML to D2
pipeline Generate workflow diagrams
rotate Rotate SVG by 90° increments
icons Browse/search D2 icon library (185+ icons)

Additional Features

  • D2 Rendering: Embedded rendering engine for SVG/PNG/PDF output
  • Icon Library: Access to 185+ D2 icons across 8 categories (essentials, dev, infra, tech, social, aws, azure, gcp)
  • JSON Schemas: Embedded schemas for DiagramSpec, PipelineSpec, and SequenceSpec

Installation

go install github.com/grokify/d2vision/cmd/d2vision@latest

Quick Start

# Parse an SVG diagram
d2vision parse diagram.svg

# Generate D2 from a template
d2vision template network-boundary --d2 | d2 - output.svg

# Learn from existing diagram
d2vision learn diagram.svg --d2 > recreated.d2

# Convert Mermaid to D2
d2vision convert diagram.mmd > diagram.d2