yshavit/mdq

Health v2 · maintenance only

Adoption not part of the score

1741 stars · 19 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

mdq is a command-line tool that works like jq but for Markdown, letting you select and render specific elements in a Markdown document using a query syntax. It is written in Rust and distributed via Homebrew, Docker, and release binaries.

Use cases

• find all uncompleted task list items in a markdown file
• extract specific sections from a markdown document
• query markdown like jq queries
• validate PR templates contain required checklist items
• extract all links from a markdown doc
• filter markdown headings and lists from scripts

When to choose

• you need to programmatically inspect or extract parts of Markdown files in shell scripts or CI
• you want a jq-like query language instead of fragile regexes over Markdown
• you need a fast, self-contained binary for Markdown processing

When to avoid

• you need to convert Markdown to other formats like HTML or PDF
• you need a Markdown editor or renderer rather than a selector
• you work with structured data formats like JSON or YAML rather than Markdown

Facets

cli-tool · maturity active

parser search-engine cli developer-tools developer-tools documentation cli windows cross-platform markdown jq-like querying rust text-processing command-line macos linux docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="yshavit/mdq")