Generate document statistics

Goal: Get a quick count of headers, paragraphs, code blocks, and links in a document, a lightweight completeness/complexity check.

Prerequisites: -A, since the counts are computed across the whole document at once.

Query

$ mq -A 'let headers = count_by(fn(x): x | select(.h);)
| let paragraphs = count_by(fn(x): x | select(.text);)
| let code_blocks = count_by(fn(x): x | select(.code);)
| let links = count_by(fn(x): x | select(.link);)
| s"Headers: ${headers}, Paragraphs: ${paragraphs}, Code: ${code_blocks}, Links: ${links}"' README.md

Output

Headers: 15, Paragraphs: 48, Code: 7, Links: 18

(Numbers above are from running this query against mq’s own README.md; they’ll drift as the README changes, so treat them as illustrative, not exact.)

Notes

• count_by(fn(x): x | select(...);) counts how many of the document’s nodes match the predicate. Swap the selector to count anything else (.code.lang == "js" for JS blocks specifically, etc.).