GitHubで★1,000超。Markdown版jqの「mq」

mq
jq に似た書き方で Markdown を絞り込み・抽出・変換するコマンドラインツール
GitHub公式サイト
公開
正式公開 2025-02-24
作り手
harehare(個人)
対応
Mac・Linux・Windows・Web
言語
英語
価格
無料(MIT ライセンス)
評価
GitHub のスター 1,065(2026-10-23)

どんなアプリか

mq は、JSON を扱う jq に似た書き方で Markdown を処理するコマンドラインツールです。Rust で書かれていて、文書の一部を切り出す、絞り込む、変換するといった操作をクエリで書けます。

mq makes working with Markdown files as easy as jq makes working with JSON.

harehare さん、GitHub の README「Why mq?」

公式サイトによると、クエリは本文の文字列ではなく Markdown の構文木をたどり、見出し・リスト・表・コードブロックを単位に対象を選びます。正規表現や自前のスクリプトを書かずに済むと説明されています。

想定している使い道は、LLM のプロンプトや出力に使う Markdown の加工、複数のドキュメントからの抜き出しと整理、たくさんの Markdown ファイルに同じ変換をかける一括処理などです。

公式サイトにはブラウザでサンプルの Markdown にクエリを実行できるプレイグラウンドがあり、「.h」で見出し、「.code」でコードブロック、「.link」でリンクを取り出す例が示されています。

サブコマンドで機能を足せる作りで、PDF や DOCX、XLSX などを Markdown に変換する mq-conv、AI アシスタントから mq のクエリを使えるようにする MCP サーバーの mq-mcp などが用意されています。

試しながらクエリを組める REPL のほか、VS Code、Neovim、Zed、JetBrains の IDE、Obsidian、GitHub Actions 向けの連携が README に挙がっています。Elixir、Python、Ruby、Java、Go から呼び出すためのバインディングもあります。

同じ分野のアプリ

名前型仕掛け対応料金
mqクエリ言語・CLIjq に似た書き方で Markdown の見出しや表、コードブロックを抽出・変換CLI(Mac・Linux・Windows)+ブラウザのプレイグラウンド無料(OSS, MIT)
ai-chat-md-export変換ChatGPT と Claude の会話履歴を Markdown ファイルに変換CLI無料(OSS, MIT)
notion-md-converter変換Notion のブロックを出力先に合わせた Markdown に変換TypeScript ライブラリ(npm)無料(OSS, MIT)
NotionMCP LightMCP サーバーMarkdown ファイルと Notion ページを相互に変換して読み書きMCP サーバー無料(OSS, MIT)
eslint-plugin-markdown-preferencesリンターMarkdown の見出しや表などの書き方を ESLint で統一ESLint プラグイン(npm)無料(OSS, MIT)

入れる前に

README の冒頭には、活発に開発を続けているプロジェクトだと書かれています。デバッガの mq-dbg は試験的な機能という扱いです。

インストール用のスクリプトを使うと、最新のバイナリが ~/.local/bin/ に入り、シェルの設定に PATH が追加されます。Homebrew、Scoop、Cargo、Docker などからも入れられ、macOS・Linux・Windows 向けのビルド済みバイナリが GitHub のリリースページで配られています。

クエリの中から外部へ HTTPS で通信する機能と、ファイルを読む機能は、はじめは無効になっています。使うときはオプションで許可し、許可するドメインやパスを絞ることもできます。

手元に入れずに使う方法として、ホスティングされた REST API も公開されています。