Interoperability

The md-utils ecosystem combines several technologies that have different but complementary jobs:

Markdown document
├── YAML frontmatter
│   ├── queried with JMESPath
│   ├── validated with JSON Schema
│   └── emitted as JSON or YAML
│       ├── JSON processed with jq
│       └── YAML processed with yq
└── Markdown body
    └── may contain embedded HTML or XML-like elements

Markdown remains the human-readable document. YAML provides structured metadata inside its frontmatter. md-utils can expose that data as JSON or YAML, query it with JMESPath, and assess it against JSON Schema constraints.

The CLI is designed to participate in larger shell workflows. Its structured output can be passed to companion tools such as jq and yq for additional selection, transformation, or conversion.