Overview

This section contains the formal specification for the TDL language.

Versions

  • v1.0 - Current stable specification

Overview

TDL documents consist of:

  1. Diagram Type: Declared with @type (e.g., @arch, @seq, @flow)

  2. Sections: Defined with [section_name] containing indented content

  3. Elements: Nodes, edges, groups, flows, and other diagram components

Design Principles

  1. Minimal Tokens: Every character should serve a purpose

  2. No Quotes: Labels and IDs don't require quoting in common cases

  3. Semantic Indentation: Structure is defined by whitespace, not brackets

  4. Sensible Defaults: Unspecified properties use intelligent defaults

Last updated