agentskillexchange Query and rewrite Markdown structure with mdq
Use mdq when an agent needs to target headings, lists, links, or other Markdown structure without falling back to brittle regex edits.
Prerequisites
mdq and Markdown files to inspect or rewrite.
Installation
Use the upstream install or setup path that matches your environment:
- brew install mdq
- docker pull yshavit/mdq
- cargo install --git https://github.com/yshavit/mdq
- cargo build
Requirements and caveats from upstream:
- reviewers to complete. Enforcing these often requires ugly regexes that are a pain to write and worse to debug. Instead,
- echo 'My example markdown' | docker run --rm -i yshavit/mdq ''
- To use a specific release version, use yshavit/mdq:. See [Docker Hub] for available version tags.
Basic usage or getting-started notes:
For example, GitHub PRs are Markdown documents, and some organizations have specific templates with checklists for all
you can (for example) ask mdq for all uncompleted tasks:
[!tip]
Source: https://github.com/yshavit/mdq
Extracted from upstream docs: https://raw.githubusercontent.com/yshavit/mdq/HEAD/README.md