QMD - Hızlı Markdown Arama

• Kişisel notlar, teknik belgeler, toplantı tutanakları gibi çeşitli Markdown tabanlı belgeleri yerelde aramak için geliştirilmiş hafif bir CLI arama motoru
• BM25 tam metin arama, vektör semantik arama ve LLM yeniden sıralama (re-ranking) özelliklerini birleştiren hibrit arama hattı
• Tüm işlemler yerel ortamda gerçekleştirilir; böylece kişisel veriler sızmadan AI düzeyinde arama kalitesi sunar
• 3 tür arama modu desteği
  • search: BM25 tabanlı anahtar kelime araması
  • vsearch: embedding tabanlı semantik arama
  • query: iki yöntemi birleştirip LLM ile yeniden sıralayan en yüksek kaliteli mod
• Yerleşik MCP(Model Context Protocol) sunucusu sayesinde Claude gibi LLM tabanlı iş akışlarıyla doğrudan entegrasyon mümkün
• node-llama-cpp aracılığıyla tüm modelleri cihaz üzerinde çalıştırır
  • embeddinggemma-300M, qwen3-reranker-0.6B, Qwen3-1.7B gibi GGUF formatlı modelleri otomatik indirip önbelleğe alır
• Arama kalitesini artırmak için kullanılan yöntemler
  • Kullanıcının arama isteği Qwen3-1.7B modeliyle sorgu genişletmeden (Query Expansion) geçirilir
  • SQLite FTS5 ve sqlite-vec üzerinden paralel arama yapılır
  • Reciprocal Rank Fusion (RRF) ile sonuçlar birleştirilir
  • Qwen3-Reranker ile belge ilgililiği yeniden değerlendirilir
  • Sıralama bazlı ağırlık ayarıyla doğruluk ve anlamsal benzerlik dengesi korunur
• TypeScript ile yazılmıştır ve Bun runtime tabanlıdır. İndeksler SQLite veritabanında saklanır
• MIT lisansı
• Shopify kurucusu ve CEO'su Tobi Lütke'nin açık kaynak projesi

Kullanım örneği

# 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  

[xguru]

Ben çeşitli bilgileri Obsidian'a kaydedip Windows + Mac + iPhone'da açıp bakıyorum,
GeekNews ile ilgili düzenlediğim bilgileri de bir Git reposuna kaydedip kullanıyorum.
Artık bunların hepsini bununla rahatça arayıp görüntüleyebiliyorum.

[haung921209]

Windows + Mac + iPhone arasında yönetimi nasıl yapıyorsunuz acaba?
Ben Windows ve Mac arasında Git ile, Mac ve iPhone arasında ise iCloud ile yönetiyorum ama yine de eksik kalan birçok nokta var. (Windows’ta Git ile commit attığımda iCloud’a otomatik yüklenmiyor.)
Merak ettiğim için soruyorum!

[xguru]

Obsidian, Windows + Mac + iPhone arasında iCloud ile senkronize ediliyor.
Ücretli Sync kullanmadan şu an için en iyi yöntem bu gibi görünüyor.