GitHubで★1,000超。Markdown版jqの「mq」
- 公開
- 正式公開 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 | クエリ言語・CLI | jq に似た書き方で 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 Light | MCP サーバー | 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 も公開されています。