Поиск
Ключевые понятия
Поиск (Search) — встроенный плагин приложения Obsidian. Позволяет найти данные в заметках хранилища.
Поисковый запрос (Search term) — слово или фраза, которую пользователь вводит в поле поиска.
Настроить плагин
Прежде чем применять необходимо включить плагин в настройках: Settings (Настройки) →
Core plugins (Встроенные плагины) → Search (Поиск).
Настроить параметры поиска
Для настройки параметра поиска следует:
- Нажать на кнопку
Search (Поиск) на панели навигации.
- Нажать на кнопку
Search settings (Настроить поиск).
- Включить любой из переключателей:
- Collapse results (Свернуть результаты). Переключает отображение контекста поиска.
- Show more context (Развернуть контекст). Расширяет результат поиска, показывая больше текста вокруг совпадения.
- Explain search terms (Объяснить поисковый запрос). Подробно разбирает в попытке объяснить сложный поисковый запрос.
Операторы поиска
Операторы поиска позволяют уточнить поисковый запрос для ускорения процесса и фильтрации результатов.
Некоторые операторы поддерживают вложенные условия. Например, task:(phone OR email).
| Оператор | Описание |
|---|---|
file: | Найти файл по наименованию. Находит любые файлы хранилища. Пример: file:.jpg или file:202209. |
path: | Найти каталог по наименованию. Пример: path:"журнал/2027-07-07". |
content: | Полнотекстовый поиск в заметке. Пример: content:"happy cat". |
match-case: | Полнотекстовый поиск в заметке с учётом регистра. Пример: match-case:pluginSearch. |
ignore-case: | Полнотекстовый поиск в заметке без учёта регистра. Пример: ignore-case:Поиск. |
tag: | Найти тег в заметке. Пример: tag:#work.См. примечание 1. |
line: | Полнотекстовый поиск в заметке, содержащей хотя бы одну строку, соответствующую условию. Пример: line:(mix flour).См. примечание 2. |
block: | Найти совпадение в пределах блока. Пример: block:(dog cat).См. примечание 3. |
section: | Найти совпадение в пределах раздела. Пример: section:(dog cat). |
task: | Найти пункт проверочного списка. Пример: task:"купить хлеб". |
task-todo: | Найти невыполненный пункт проверочного списка. Пример: task-todo:"купить хлеб". |
task-done: | Найти невыполненный пункт проверочного списка. Пример: task-done:"купить хлеб". |
Примечание 1
Поиск тега не учитывает вложенных тегов. Например, запрос tag:#work не найдет тег tag:#project/work. Кроме того, оператор tag: игнорирует совпадения внутри блока кода. В результате запрос tag:#work плагин выполняет быстрее полнотекстового запроса content:#work.
Примечание 2
Использование отрицания -line (дефис перед line) инвертирует условие поиска. Плагин будет искать файлы, в которых нет ни одной строки, соответствующей условию.
Примечание 3
Поскольку при поиске блоков кода плагин анализирует разметку Markdown в каждом файле, выполнение запроса занимает продолжительное время.
Логические операторы
В строку поиска можно включать логические операторы конъюнкции (AND), дизъюнкции (OR), отрицания (NOT), а также операторы сравнения больше (>) или меньше (<).
Отсутствие оператора между словами поиска соответствует оператору конъюнкции (AND). Например, запрос совещание задание соответствует запросу совещание AND задание. Другими словами, будут найдены и заметки со словом совещание, и заметки со словом задание.
Оператор дизъюнкции (включающего OR) позволяет найти заметки либо со словом совещание, либо заметки со словом задание.
Операторы можно комбинировать. Например, совещание задание OR личные дела соответствует запросу совещание AND задание OR личные AND дела.
Скобки управляют приоритетом запроса. Например, запрос совещание (задание OR дела) личные будет действовать следующим образом:
- плагин найдёт заметки со словом
совещание; - затем найдёт заметки со словом
личные; - затем будет искать
задание, а если не найдёт, тодела.
Оператор отрицания (-) исключает слово из поиска. Например, совещание -задание не будет искать заметки со словом задание. В один запрос можно включить несколько отрицаний. Например, совещание -задание -дела исключит оба слова.
С помощью скобок из запроса можно исключить комбинацию слов. Например, совещание -(задание дела) найдёт заметки, содержащие слово совещание. Но исключит заметки, содержащие одновременно слова задание и дела.
Операторы больше (>) и меньше (<) используют для фильтрации поиска. В строке поиска их следует заключить либо в квадратные [ ], либо двойные (" “) кавычки. Например:
совещание [длительность:<5]найдёт заметки со словомсовещаниеи полем метаданныхдлительность, у которого значение меньше 5.
Поиск по всему хранилищу
Плагин позволяет проводить поиск как внутри отдельной заметки, так и по всем файлам хранилища.
Умение пользователя правильно вводить поисковый запрос ускоряет получение успешного результата даже в обширном хранилище.
Обратите внимание!
Плагин осуществляет полнотекстовый поиск только в заметках и канве!
Для поиска по всему хранилищу существуют следующие способы вызова поисковой строки:
- кнопка поиска навигационной панели;
- выделенная строка и сочетание клавиш;
- повтор недавних поисковых запросов.
Кнопка поиска расположена на панели навигации.
Если выделить в гипертексте строку, а затем нажать сочетание клавиш <Ctrl+Shift+F>, то выделенная строка будет вставлена в поисковый запрос.
Если необходимо повторить ранее вводимый запрос, следует:
- Открыть поиск.
- В разделе History (История) просмотреть список предыдущих запросов.
- Выбрать строку запроса для повтора.
В результат поиска не войдут заметки, включённые в список исключённых файлов. Изменить список следует в Settings (Настройки) →
(Файлы и ссылки) → (Дополнительные настройки) → (Исключённые файлы и каталоги).
Для уточнения результатов поиска используют поисковые запросы и специальные операторы.
Точность запроса
Для повышения точности поиска заключите поисковую строку в двойные кавычки. Например, “плагин поиска”. Если поисковый запрос содержит кавычки, их следует экранировать обратной косой чертой (\). Например, “книга Л.Н. Толстой \«Война и мир\» “.
По умолчанию поиск не чувствителем к регистру глифа. Для повышения точности и скорости поиска пользователь может включить регистр одним из следующих способов:
- добавить в начало запроса оператор
match-case:; - нажать на кнопку
Match case (Учитывать регистр), расположенную в поле поиска справа.
Поиск по наименованию файла
Для поиска по наименованиям файлов следует в поле поиска использовать оператор file. Например:
file:.png— поиск файлов изображений формата.PNG;file:20290401— поиск файла с идентификатором «20290401».
Поиск по расположению и наименованию файла
Для поиска каталога или пути (последовательности вложенных каталогов) следует использовать оператор path. Например:
path:"журнал/2027-07-07"— поиск в каталоге “журнал”, а затем во вложенном подкаталоге “2027-07-07”.
Каждый оператор действует независимо. Поэтому пользователь может применять одновременно несколько операторов. Например, сочетать path и file:
path:"журнал/2029-04" file:20290401— поиск файла в каталоге “журнал” и подкаталоге «2029-04».
Поиск по метаданным
Пользователю доступен поиск по метаданным заметок. Для поиска заметок, содержащих определённое наименование метаданных в поисковом запросе следует заключить наименование в квадратные скобки. Например, поиск по псевдонимам [aliases].
Для поиска заметок, содержащих не только наименование, но и значение метаданных в поисковом запросе следует:
- указать наименование поля метаданных;
- через двоеточие указать значение поля метаданных;
- заключить запрос в квадратные скобки.
Синтаксис запроса метаданных со значением: [property:value]. Пример поиска по полю aliases и значению fileName метаданных: [aliases:fileName].
Для поиска заметок, содержащих наименование и пустое значение метаданных в поисковом запросе следует:
- указать наименование поля метаданных;
- через двоеточие указать слово
nullв значении поля метаданных; - заключить запрос в квадратные скобки.
Синтаксис запроса для поиска пустого значения: [property:null]. Пример поиска по пустому значению метаданных: [aliases:null].
Примечание
Оператор null не срабатывает, если в поле значений использованы пустые кавычки (" ") или пустые квадратные скобки ([ ]).
Как для наименования [property], так и для значения [value] метаданных можно использовать дополнительные элементы запроса:
- круглые скобки для группировки;
- оператор
OR(логическое ИЛИ); - двойные кавычки для точного соответствия;
- регулярные выражения.
Пример поиска заметок, в которых поле status содержит значения Draft или Published: [status:Draft OR Published].
Сортировать результат поиска
Как только в список отобразил результат поиска, под полем поиска стал доступен выпадающий список. Если нажать на кнопку разворачивания списка, то станут доступны следующие варианты сортировки списка результатов:
- File name (A to Z). По имени файла (от А до Я).
- File name (Z to A). По имени файла (от Я до А).
- Modified time (new to old). По времени последнего изменения (от новых к старым).
- Modified time (old to new). По времени последнего изменения (от старых к новым).
- Created time (new to old). По времени создания (от новых к старым).
- Created time (old to new). По времени создания (от старых к новым).
Копировать результат поиска
Под полем поиска расположено поле results (результаты). Справа от этого поля кнопка с тремя точками. Следует нажать на кнопку и выбрать один из пунктов:
- Copy search results (Копировать результат поиска);
- Bookmark (Добавить в закладки).
Встроить поиск в заметку
Поисковый запрос можно встроить в заметку для того, чтобы получать динамически обновляемые данные при открытии заметки.
Пример встроенного в заметку поискового запроса:
``` query
"поиск" OR "поисковый запрос"
```Локальный поиск и замена
Локальный поиск в пределах одной заметки позволяет мгновенно находить, подсвечивать и заменять текст открытой заметки.
Локальный поиск и замена
Вызвать локальный поиск можно сочетанием клавиш Ctrl-F. Вызов открывает поле поиска в верхней части открытой заметки.
В строке поиска видно количество найденных совпадений.
Для навигации по найденным результатам можно использовать:
- кнопки со стрелками
вверх и
вниз, расположенными на панели поиска;
- клавишей
Enterдля движени вниз и сочетанием клавишShift+Enterдля движения вверх по тексту.
Локальная замена
Вызвать локальную замену можно сочетанием клавиш Ctrl-H. Вызов открывает поле поиска и поле замены в верхней части открытой заметки.
В поле замены доступны:
- кнопка
Replace (Заменить), которая заменяет подсвеченный результат поиска;
- кнопка
Replace All (Заменить все), которая заменяет все найденные результаты поиска.