Show HN: Jq-Like Tool for Markdown
Published on: 2025-07-14 10:05:49
mdq: jq for Markdown
What is mdq?
mdq aims to do for Markdown what jq does for JSON: provide an easy way to zero in on specific parts of a document.
For example, GitHub PRs are Markdown documents, and some organizations have specific templates with checklists for all reviewers to complete. Enforcing these often requires ugly regexes that are a pain to write and worse to debug. Instead, you can (for example) ask mdq for all uncompleted tasks:
mdq ' - [ ] '
mdq is available under the Apache 2.0 or MIT licenses, at your option. I am open to other permissive licenses, if you have one you prefer.
Installation
Any of these will work:
cargo install --git https://github.com/yshavit/mdq Download binaries from the latest release (or any other release, of course). You can also grab the binaries from the latest build-release workflow run. You must be logged into GitHub to do that (this is GitHub's limitation, not mine). You'll have to chmod +x them before you can run them.
Security concer
... Read full article.