用途:mq 被称为“Markdown 的 jq”,它把 .md 文件解析为节点流,让你按结构(如 .h2、.code("rust")、.link)而非按行匹配来选取、过滤和转换内容。适合结构性任务:提取每个 H2 标题、所有 bash 代码块、生成目录、去除 frontmatter。纯子串搜索仍应用 grep;代码内部结构(AST、符号)应使用 tree-sitting。
主要能力:选择器(.h、.code、.link)挑选节点,函数(to_text、slugify、map、len)转换节点,self 表示当前节点。支持文件或标准输入查询,以及交互式 REPL。
使用方式:安装(幂等,约 1 秒,无构建步骤):bash /mnt/skills/user/querying-markdown/scripts/install-mq.sh,可用 MQ_VERSION=vX.Y.Z 覆盖版本。用法示例:mq 'QUERY' file.md;cat file.md | mq 'QUERY';mq repl。示例:mq '.h2 | to_text()' README.md;mq '.code("python") | to_text()' file.md;mq -F json '.h2 | to_text()' file.md。
限制:mq 每次调用都会重新解析整个文档,延迟随文档大小而非匹配数变化;大文件上每次查询约 3.2–3.3 秒,普通文档为毫秒级。不要对大语料逐条循环调用,建议用 -F json 一次性提取。选择器返回的是节点而非领域概念,原始计数需用显式谓词映射并核对。空结果可能表示未匹配或命令未执行,应先用裸命令复跑确认。方言类似 jq 但函数名不同,复杂查询前应查阅 references/cheatsheet.md。