Meld Directives

Directives are the core building blocks of Meld. They always start with an @ symbol and must appear at the beginning of a line (no indentation). Each directive has a specific purpose and syntax.

Available Directives

  • @text - Define text variables
  • @data - Define structured data variables
  • @path - Define filesystem path variables
  • @embed - Include content from other files
  • @run - Execute shell commands and include output
  • @import - Import variables and commands from other Meld files
  • @define - Create reusable commands

Directive Placement Rules

  • Directives must appear at the start of a line (no indentation)
  • @import directives should generally appear at the top of the file
  • Other directives can appear anywhere in the file
  • Directives inside code fences ( ) are treated as plain text

Common Syntax Elements

Most directives follow this general pattern:

@directive [required] optional

Where:

  • @directive is the directive name
  • [required] is required content in brackets
  • optional is additional optional content

Next Steps

For detailed information on each directive, follow the links above or explore the individual documentation files.