QMD - búsqueda rápida en Markdown

• Motor de búsqueda CLI ligero desarrollado para buscar localmente documentos basados en Markdown como notas personales, documentación técnica y actas de reuniones
• Pipeline de búsqueda híbrida que combina búsqueda de texto completo BM25, búsqueda semántica vectorial y reordenamiento (re-ranking) con LLM
• Todas las operaciones se ejecutan en el entorno local, lo que ofrece calidad de búsqueda a nivel de IA sin filtrar datos personales
• Compatible con 3 modos de búsqueda
  • search: búsqueda por palabras clave basada en BM25
  • vsearch: búsqueda semántica basada en embeddings
  • query: combina ambos métodos y reordena con un LLM para el modo de mayor calidad
• Incluye servidor MCP (Model Context Protocol), por lo que puede integrarse directamente con flujos de trabajo basados en LLM como Claude
• Ejecuta todos los modelos en el dispositivo mediante node-llama-cpp
  • Descarga y almacena automáticamente en caché modelos en formato GGUF como embeddinggemma-300M, qwen3-reranker-0.6B y Qwen3-1.7B
• Métodos usados para mejorar la calidad de búsqueda
  • Expansión de consulta (Query Expansion) de lo solicitado por el usuario con el modelo Qwen3-1.7B
  • Búsqueda paralela mediante SQLite FTS5 y sqlite-vec
  • Integración de resultados con Reciprocal Rank Fusion (RRF)
  • Reevaluación de la relevancia de documentos con Qwen3-Reranker
  • Ajuste de pesos por posición para mantener el equilibrio entre precisión y similitud semántica
• Escrito en TypeScript y basado en el runtime Bun. El índice se almacena en una base de datos SQLite
• Licencia MIT
• Open source de Tobi Lütke, fundador y CEO de Shopify

Ejemplos de uso

# 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 "Notas personales e ideas"  
qmd context add qmd://meetings "Transcripciones y notas de reuniones"  
qmd context add qmd://docs "Documentación de trabajo"  
  
# 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]

Yo guardo diversa información en Obsidian y la consulto desde Windows + Mac + iPhone, además de que la información que organizo relacionada con GeekNews la dejo registrada en un repo de Git para usarla. Ahora ya puedo buscarla y verla cómodamente desde un solo lugar.

[haung921209]

¿Cómo gestionan ustedes entre Windows + Mac + iPhone?
Yo gestiono entre Windows y Mac con Git, y entre Mac e iPhone con iCloud, pero de todos modos hay bastantes cosas que se quedan cortas. (Aunque hice commit con Git en Windows, no se sube automáticamente a iCloud).
¡Les pregunto porque me da curiosidad!

[xguru]

Obsidian se sincroniza por iCloud en Windows + Mac + iPhone.
Sin usar Sync, que es de pago, creo que por ahora esta es la mejor manera.