mdq Markdown 结构查询改写

正则改 Markdown 有多痛

处理 Markdown 文档时，常需精准修改标题层级、筛选列表项或提取链接。传统正则匹配虽能实现，但正则规则复杂易错，调试耗时，且面对嵌套列表、混合格式（如带复选框的任务清单）时几乎失效。

mdq 如何精准重构结构

mdq 是面向 Markdown 结构的查询工具，能通过语法直接定位目标元素：

• 支持按类型筛选：[]() 匹配链接，[! ] 匹配复选框任务；
• 支持条件查询：如提取所有未完成的 - [ ] 任务项；
• 支持结构化重写：修改标题层级时无需处理行号，直接按元素操作。

核心逻辑是将结构解析与文本处理解耦，输入 Markdown 后，mdq 解析为结构化对象，再按查询规则输出修改后的 Markdown，避免正则对文本的直接操作。

适用场景与边界

适合需要频繁操作 Markdown 结构的场景：GitHub PR 模板的待办清单更新、文档目录自动生成、多级标题批量调整等。需注意：

• 依赖 mdq 工具的安装环境；
• 对超大型文档的处理性能需提前验证；
• 复杂格式（如自定义 HTML 标签）可能超出当前支持范围。