# mdq: find specific elements in a md doc

<https://github.com/yshavit/mdq>

- Host: [github.com](https://links.thingelstad.xyz/hosts/github.com/)
- Saved: February 25, 2025 (2025-02-26T02:34:43Z)
- Record: https://links.thingelstad.xyz/links/3e82121b787d/
- JSON: https://links.thingelstad.xyz/links/3e82121b787d.json

## What Jamie wrote

This tool made me chuckle because I've always thought one of the cool things about Markdown files is that they have a structure to them per se, and you can use that structure to create things like a table of contents, or build programmatic content off of. For example, `mdq` would make it very easy for me to generate an index for each issue of the Weekly Thing and let you jump to each specific section or link. Or even just do a `find` on a directory with all the issues, pipe them through `mdq` and use simple `wc -l` to answer questions like "How many links did I share in 2024?". Cool stuff!

## Facts

- Kind: [Repository](https://links.thingelstad.xyz/kinds/repository/)
- Repository: yshavit/mdq: like jq but for Markdown: find specific elements in a md doc
- About the repository: Rust, 1,747 stars, Apache-2.0, last push September 7, 2026

## Appears in

- [WT311: Weekly Thing 311 / WikiTok, Bookmarklets, Tapestry](https://weekly.thingelstad.com/archive/311/), Notable

## Same host

- [markitdown: Python tool for converting files and office documents to Markdown](https://links.thingelstad.xyz/links/33054ecb8bf0/) (github.com, December 20, 2024)
- [stats: macOS system monitor in your menu bar](https://links.thingelstad.xyz/links/33c54927ef77/) (github.com, February 2, 2025)
- [awesome-mcp-servers: A collection of MCP servers.](https://links.thingelstad.xyz/links/396cb5e37f28/) (github.com, April 10, 2025)
- [codex: Lightweight coding agent that runs in your terminal](https://links.thingelstad.xyz/links/1a57528ba5a4/) (github.com, April 17, 2025)
- [dir2txt: A blazing-fast CLI tool to export a directory's structure and contents for AI](https://links.thingelstad.xyz/links/7b84c6b88a8c/) (github.com, May 1, 2025)

## Saved the same week

- [Tapestry: Past, Present, and Future • The Breakroom](https://links.thingelstad.xyz/links/1231c4e6be29/) (blog.iconfactory.com, February 25, 2025)
- [WikiTok](https://links.thingelstad.xyz/links/e1c4acba0a7f/) (wikitok.vercel.app, February 25, 2025)
- [Apple Vision Glasses Will Be Irresistible](https://links.thingelstad.xyz/links/f3b4768896d0/) (notebook.lachlanjc.com, February 27, 2025)
- [Daring Fireball: Apple Pulls Advanced Data Protection From the UK, in Defiance of UK Demand for Global Backdoor](https://links.thingelstad.xyz/links/ebd81c216a24/) (daringfireball.net, February 27, 2025)
- [Migraine is more than a headache — a radical rethink offers hope to one billion people](https://links.thingelstad.xyz/links/c2f7fab68801/) (nature.com, February 27, 2025)

## Elsewhere

- Wayback Machine: https://web.archive.org/web/*/https://github.com/yshavit/mdq