Skip to content

markdown-syntax.md

Latest commit

 

History

History
93 lines (63 loc) · 1.34 KB

markdown-syntax.md

File metadata and controls

93 lines (63 loc) · 1.34 KB
Raw

Markdown Syntax Reference

Mudyla parses Markdown files in .mdl/defs/.

Global Sections

Arguments

# arguments

- `args.name`: Description
  - type: `string` | `int` | `file` | `directory`
  - default: `"value"`

Flags

# flags

- `flags.debug`: Enable debug mode

Environment

# environment

- `LANG=C.UTF-8`

## passthrough

- `HOME`
- `PATH`

Axes

# Axis

- `mode`=`{dev*|prod}`

Action Sections

# action: name

## vars
- `REQUIRED_ENV_VAR`: description

## definition [when `condition`]

```bash
...
```

(Note: Code blocks use triple backticks).

Dependencies

  • dep action.name
  • dep env.NAME
  • soft action.name retain.action.decider
  • weak action.name

Expansions

  • ${sys.project-root}
  • ${env.VAR_NAME}
  • ${args.arg-name}
  • ${flags.flag-name}
  • ${action.action-name.output} (Strong dependency)
  • ${action.weak.action-name.output} (Weak access, returns "" if missing)
  • ${retained.weak.action-name} (Returns "1" if present, "0" if missing)
  • ${retained.soft.action-name} (Alias for above)

Commands (Bash)

Inside Bash blocks, Mudyla injects specific helper functions:

Return Output:

ret name:type=value

Signal Retention (for Soft Dependencies):

retain