fn_registry/python/functions/obsidian/search_obsidian_notes.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
search_obsidian_notes	function	py	obsidian	1.0.0	impure	search_obsidian_notes(vault_dir: str, query: str, in_body: bool = True, in_frontmatter: bool = True) -> list	Busca un substring (case-insensitive) en todas las notas .md de un vault de Obsidian, excluyendo .obsidian/ y .trash/. Devuelve por nota las lineas que contienen el query con su numero de linea. Los flags in_body/in_frontmatter acotan donde buscar.	obsidian notes search grep vault frontmatter filesystem	parse_obsidian_frontmatter_py_obsidian			false	error_go_core	os	name desc vault_dir path a la raiz del vault de Obsidian a buscar name desc query substring a buscar (matcheado de forma case-insensitive); no puede ser vacio name desc in_body buscar en el cuerpo de la nota cuando es True (defecto True) name desc in_frontmatter buscar en el bloque de frontmatter cuando es True (defecto True)	lista de dicts {path, matches} (uno por nota con coincidencias), ordenada por path; cada match es {line, text} con numero de linea 1-based relativo al archivo completo	false			python/functions/obsidian/search_obsidian_notes.py

Ejemplo

from obsidian import search_obsidian_notes

# Buscar "presupuesto" en todo el vault (frontmatter + cuerpo)
hits = search_obsidian_notes("/home/enmanuel/Obsidian/Finanzas", "presupuesto")
for h in hits:
    print(h["path"])
    for m in h["matches"]:
        print(f"  L{m['line']}: {m['text']}")

# Solo en el cuerpo, ignorando el frontmatter
solo_cuerpo = search_obsidian_notes(
    "/home/enmanuel/Obsidian/Finanzas", "TODO", in_frontmatter=False
)

Cuando usarla

Cuando necesites un grep de un solo paso sobre un vault de Obsidian: encontrar en que notas aparece un termino y en que lineas, antes de abrir/editar. Util para auditar tags, localizar referencias o construir un indice de busqueda.

Gotchas

• Impura: lee el filesystem. Lanza ValueError si query es vacio, FileNotFoundError si el vault no existe y NotADirectoryError si no es un directorio.
• Exclusion obligatoria: .obsidian/ y .trash/ se podan del recorrido; su contenido nunca se busca ni aparece en resultados.
• Coste en vaults grandes: abre y lee CADA nota .md linea a linea. En vaults pesados como NotasDeObsidian (~554M) esto recorre todo el contenido en memoria por archivo; puede tardar. Acota el vault o pre-filtra con list_obsidian_notes si necesitas rendimiento.
• Numeros de linea: son 1-based y relativos al archivo completo (incluyen las lineas del frontmatter ---), de modo que mapean directamente sobre el archivo en disco aunque se busque solo en cuerpo o solo en frontmatter.
• La delimitacion frontmatter/cuerpo se calcula con parse_obsidian_frontmatter; si la nota no tiene frontmatter valido, todo se considera cuerpo.
• Archivos con encoding invalido se leen con errors="replace".