Skip to content

CLI Commands Reference

Complete reference for all MIDI Markdown CLI commands.

Overview

The mmdc command-line tool provides several commands for working with MMD files. Each command is documented in detail in the CLI Reference section.

Quick Reference

Compilation Commands

  • compile - Compile MMD to MIDI, JSON, or CSV
  • validate - Validate MMD files without compiling
  • check - Quick syntax check

Playback Commands

  • play - Real-time MIDI playback with TUI
  • inspect - Inspect compiled events

Interactive Commands

  • repl - Interactive REPL mode

Common Usage Patterns

Compile to MIDI

mmdc compile song.mmd -o output.mid

Validate Before Compiling

mmdc validate song.mmd && mmdc compile song.mmd -o output.mid

Real-time Playback

mmdc play song.mmd --port 0

Export to JSON

mmdc compile song.mmd --format json -o events.json

See Also