Concepts
JMESPath
Query YAML frontmatter with the JMESPath language built into md-utils.
JMESPath is a query language for JSON-shaped data. md-utils evaluates JMESPath expressions directly against each file’s parsed YAML frontmatter.
Use md-utils fm search when the query should decide which files match:
md-utils fm search 'draft == `true`' .
md-utils fm search 'contains(tags, `"swift"`)' posts/
md-utils fm search 'draft == `false` && author == `"Jane"`' .
Wrap the complete expression in single quotes. JMESPath literals use backticks, which an unquoted or double-quoted shell argument may interpret as command substitution.
Use JMESPath for selection inside md-utils. Use jq
or yq when you need to reshape or further process
the command’s structured output.