README

TDL is a modern, text-based language for defining software architecture diagrams. It is optimized for:

1. LLM Generation: High token efficiency means faster and cheaper generation by AI agents

2. Human Readability: Clean, indentation-based syntax inspired by Python and YAML

3. Professional Output: Renders into beautiful, presentation-ready diagrams

Example

@arch Microservices Architecture

[nodes]
  gateway:API Gateway|icon:aws-api-gateway
  auth:Auth Service|icon:gilbarbara-auth0
  db:User Database|cyl|icon:devicon-postgresql

[edges]
  gateway->auth:validates
  auth->db:queries

[groups]
  backend:Backend Services
    auth
    db

Rendered diagram

Documentation

• Specification: The formal TDL language standard

• Getting Started: Write your first TDL diagram

• Syntax Reference: Complete syntax guide

Implementations

• Architoon - Web editor

  • MCP & Cursor / VS Code extensions coming soon!