QMD - クイックMarkdown検索

 (github.com/tobi)
35 ポイント 投稿者 xguru 2026-01-29 | 3件のコメント | WhatsAppで共有
  • 個人ノート、技術文書、議事録など、さまざまな Markdownベースの文書をローカルで検索 するために開発された 軽量CLI検索エンジン
  • BM25全文検索、ベクトル意味検索、LLM再ランキング（re-ranking） を組み合わせた ハイブリッド検索パイプライン
  • すべての処理が ローカル環境で実行 されるため、個人情報の流出なしに AIレベルの検索品質 を提供
  • 3つの 検索モードをサポート
    • search: BM25ベースのキーワード検索
    • vsearch: 埋め込みベースの意味検索
    • query: 2つの方式を組み合わせ、LLMで再ランキングする 最高品質モード
  • MCP(Model Context Protocol) サーバーを内蔵し、Claude など LLMベースのワークフローと直接連携 可能
  • node-llama-cpp を通じて、すべてのモデルを オンデバイスで実行
    • embeddinggemma-300M、qwen3-reranker-0.6B、Qwen3-1.7B などの GGUF形式モデル を自動ダウンロードしてキャッシュ
  • 検索品質を向上 させる方法
    • ユーザーの検索リクエストに対して Qwen3-1.7B モデルでクエリ拡張（Query Expansion）を実行
    • SQLite FTS5 と sqlite-vec による並列検索を実施
    • Reciprocal Rank Fusion (RRF) で結果を統合
    • Qwen3-Reranker で文書の関連度を再評価
    • 順位ごとの重み調整により 精度と意味的類似性のバランスを維持
  • TypeScript で書かれており、Bunランタイム ベース。インデックスは SQLiteデータベース に保存
  • MITライセンス
  • Shopify創業者兼CEOの Tobi Lütke によるオープンソース

使用例

# Install globally  
bun install -g https://github.com/tobi/qmd  
  
# Create collections for your notes, docs, and meeting transcripts  
qmd collection add ~/notes --name notes  
qmd collection add ~/Documents/meetings --name meetings  
qmd collection add ~/work/docs --name docs  
  
# Add context to help with search results  
qmd context add qmd://notes "Personal notes and ideas"  
qmd context add qmd://meetings "Meeting transcripts and notes"  
qmd context add qmd://docs "Work documentation"  
  
# Generate embeddings for semantic search  
qmd embed  
  
# Search across everything  
qmd search "project timeline"           # Fast keyword search  
qmd vsearch "how to deploy"             # Semantic search  
qmd query "quarterly planning process"  # Hybrid + reranking (best quality)  
  
# Get a specific document  
qmd get "meetings/2024-01-15.md"  
  
# Get a document by docid (shown in search results)  
qmd get "#abc123"  
  
# Get multiple documents by glob pattern  
qmd multi-get "journals/2025-05*.md"  
  
# Search within a specific collection  
qmd search "API" -c notes  
  
# Export all matches for an agent  
qmd search "API" --all --files --min-score 0.3

関連記事

3件のコメント

 
xguru 2026-01-29

私は Obsidian にさまざまな情報を記録しておいて、Windows・Mac・iPhone で呼び出して見ています。
GeekNews 関連で整理する情報は Git Repo に記録して使っているのですが、
これ一つで手軽に検索して見られるようになりましたね。
 
haung921209 2026-02-05

みなさんは、Windows・Mac・iPhone間の管理をどうしていますか?
私はWindowsとMacの間はGitで、MacとiPhoneの間はiCloudで管理しているのですが、どうしても物足りない部分が多くて……。（WindowsでGitにコミットしても、iCloudには自動アップロードされない状況です）
気になっているので、お聞きしたいです!
 
xguru 2026-02-05

Obsidian は Windows・Mac・iPhone のすべてを iCloud で同期しています。
有料の Sync を使わないなら、現時点ではこれがいちばん良い方法だと思います。