Свойства позволяют организовать информацию о заметке. Свойства содержат структурированные данные: текст, ссылки, даты, флажки и числа. Свойства также можно использовать в сочетании с [[Сторонние плагины|плагинами сообщества]], которые могут выполнять полезные действия с вашими структурированными данными. ## Добавление свойств к заметке Существует несколько способов добавить свойство к заметке: - Используйте [[Палитра команд|команду]] **Добавить свойство файла**. - Используйте [[Горячие клавиши|сочетание клавиш]] **`Cmd/Ctrl+;`**. - Выберите **Добавить свойство файла** в меню **Дополнительные действия** (вызываемом нажатием на значок с тремя точками или щелчком правой кнопкой мыши по вкладке). - Введите `---` в самом начале файла. После добавления свойства в верхней части файла появится строка с двумя полями: _название_ свойства и _значение_ свойства. В качестве названия вы можете выбрать что угодно. Obsidian предоставляет несколько свойств по умолчанию: `tags`, `cssclasses` и `aliases`. После выбора названия свойства вы можете присвоить ему значение. ### Типы свойств Помимо названия и значения, свойства также имеют _тип_. Тип свойства определяет, какие значения оно может хранить и как Obsidian их обрабатывает. Чтобы изменить тип свойства, нажмите на значок типа рядом с названием свойства и выберите другой вариант. Вы также можете управлять типами свойств с помощью основного плагина [[Просмотр свойств]]. Obsidian поддерживает следующие типы свойств: - **[[#Текст]]** - **[[#Список]]** - **[[#Число]]** - **[[#Флажок]]** - **[[#Дата]]** - **[[#Дата и время]]** - **[[#Теги]]** После назначения типа свойства определённому названию все свойства с этим названием в вашем хранилище будут использовать тот же тип. ## Расширенное использование ### Поиск по свойствам Свойства имеют собственный [[Поиск|синтаксис поиска]], который можно использовать вместе с другими поисковыми запросами и операторами. [[Поиск#Поиск по свойствам|Смотрите синтаксис поиска по свойствам]]. ### Шаблоны Вы можете добавлять свойства в [[Шаблоны|шаблоны]]. Когда вы вставляете шаблон в текущую заметку, все свойства из шаблона будут добавлены в заметку. Obsidian также объединит существующие свойства заметки со свойствами из шаблона. ^templates-properties ### Переименование свойств Вы можете переименовать свойство, щёлкнув по нему правой кнопкой мыши в представлении [[Просмотр свойств|Все свойства]]. ### Режимы отображения Вы можете изменить способ отображения свойств в заметке, перейдя в **[[Настройки]] → Редактор → Свойства в документе**. Доступны следующие варианты: - **Видимый** (по умолчанию) — отображает свойства в верхней части заметки, если они есть. - **Скрытый** — скрывает свойства, но их можно просмотреть на боковой панели через [[Просмотр свойств]]. - **Исходный** — отображает свойства в формате YAML в виде обычного текста. ### CSS-сниппеты Вы можете использовать [[CSS-сниппеты]] для изменения внешнего вида отдельных заметок. ### Неподдерживаемые возможности Некоторые возможности в настоящее время не поддерживаются в Obsidian: - **Вложенные свойства**: Для просмотра вложенных свойств рекомендуется использовать [[Режимы просмотра и редактирования#Режим исходного кода|режим исходного кода]]. - **Массовое редактирование свойств**: Для углублённого массового редактирования за пределами [[Просмотр свойств]] рекомендуется использовать инструменты массового редактирования, такие как VSCode, скрипты и плагины сообщества. - **Markdown в свойствах**: Это намеренное ограничение, поскольку свойства предназначены для небольших, атомарных фрагментов информации, которые удобно читать как людям, так и машинам. ## Сочетания клавиш ### Добавление свойства | Действие | Сочетание клавиш | |---|---| |Добавить новое свойство|`Cmd + ;`| ### Навигация между свойствами Когда свойство в фокусе: | Действие | Сочетание клавиш | |---|---| |Перейти к следующему свойству|`Стрелка вниз` или `Tab`| |Перейти к предыдущему свойству|`Стрелка вверх` или `Shift+Tab`| |Перейти к редактору|`Alt+Стрелка вниз`| ### Выделение свойств | Действие | Сочетание клавиш | |---|---| |Расширить выделение вверх|`Shift+Стрелка вверх`| |Расширить выделение вниз|`Shift+Стрелка вниз`| |Выбрать все|`Cmd+A`| ### Редактирование свойств | Действие | Сочетание клавиш | |---|---| |Редактировать название свойства|`Стрелка влево`| |Редактировать значение свойства|`Стрелка вправо`| |Фокус на свойстве|`Escape`| |Удалить свойство|`Cmd+Backspace`<br><br>если выделены какие-либо свойства, будет удалено выделение.| |Отменить|`Cmd+Z`| |Повторить|`Cmd+Shift+Z`| ### Vim (расширенные) | Действие | Сочетание клавиш | |---|---| |Переместиться вниз|`j`| |Переместиться вверх|`k`| |Фокус на ключе|`h`| |Фокус на значении|`l`| |Фокус на значении (курсор в конце)|`A`| |Фокус на значении (курсор в начале)|`i`| |Создать новое свойство|`o`| ## Формат свойств Свойства хранятся в формате [YAML](https://yaml.org/) в начале файла. YAML — это популярный формат, который легко читается как людьми, так и компьютерами. Названия свойств отделяются от значений двоеточием с пробелом: ```yaml --- name: value --- ``` Хотя порядок пар «название-значение» не имеет значения, каждое название должно быть уникальным в пределах заметки. Например, у вас не может быть более одного свойства `tags`. Значения могут быть [[#Текст|текстом]], [[#Число|числами]], [[#Флажок|флажками]], [[#Дата|датами]], [[#Дата и время|датами и временем]] или [[#Список|списками]]. ### Текст Текстовые свойства содержат одну строку текста. Форматирование Markdown не отображается в текстовых свойствах. Хештеги не создают теги при использовании в текстовых свойствах. Текстовые свойства могут содержать URL-адреса и [[Внутренние ссылки]] с использованием синтаксиса `[[Ссылка]]`. [[Внутренние ссылки]] в текстовых свойствах должны быть заключены в кавычки. Obsidian автоматически добавит их, если вы вручную введёте внутренние ссылки в свойства, но будьте внимательны и добавляйте их при использовании плагинов для шаблонов. ```yaml --- title: A New Hope link: "[[Episode IV]]" url: https://www.example.com --- ``` ### Список Свойства-списки содержат несколько значений. Каждое значение в списке располагается на отдельной строке, начинаясь с дефиса (-) и пробела. Значения списка могут содержать текст, числа и [[Внутренние ссылки]]. При использовании [[Внутренние ссылки|внутренних ссылок]] в свойствах-списках заключайте их в кавычки. ```yaml --- cast: - Mark Hamill - Harrison Ford - Carrie Fisher links: - "[[Link]]" - "[[Link2]]" --- ``` ### Число Числовые свойства всегда должны быть буквальным числом, а не выражением с операторами. Допускаются как целые числа, так и десятичные дроби. ```yaml --- year: 1977 pie: 3.14 --- ``` ### Флажок Свойства-флажки имеют значение `true` или `false`. В динамическом просмотре они отображаются как флажок. ```yaml --- favorite: true reply: false last: # Неопределённое значение; часто обрабатывается как false ``` ### Дата Свойства-даты хранятся в следующем формате: ```yaml --- date: 2020-08-21 --- ``` Средство выбора даты следует формату даты и времени, установленному по умолчанию в вашей операционной системе. Вы можете изменить его в системных настройках: > [!info]- Windows > **[[Настройки]] → Время и язык → Язык и регион → Региональный формат → Изменить форматы** > > ![[Windows-OS-DateTime.png#interface]] > [!info]- Mac OS > **Системные настройки → Язык и регион → Формат даты** > > ![[Mac-OS-DateTime.png|450]] При включённом плагине [[Ежедневные заметки]] свойство-дата дополнительно будет работать как внутренняя ссылка на соответствующую ежедневную заметку для этой даты. ![[Ежедневные заметки#^daily-notes-date]] ### Дата и время Свойства «дата и время» включают дату и конкретное время и хранятся в следующем формате: ```yaml --- time: 2020-08-21T10:30:00 --- ``` Как и для [[#Дата|свойств-дат]], средство выбора даты и времени следует формату, установленному по умолчанию в вашей операционной системе. Вы можете изменить его в системных настройках. ### Теги Свойства-теги — это специальный тип свойств, используемый исключительно для свойства `tags`. Этот тип свойства не может быть назначен другим свойствам. Свойства-теги форматируются как список, где каждый тег располагается на отдельной строке, начинаясь с дефиса (-) и пробела. ```yaml --- tags: - journal - personal - draft --- ``` Свойство `tags` является одним из [[#Свойства по умолчанию|свойств по умолчанию]] Obsidian. Подробнее об использовании тегов в Obsidian см. в разделе [[Теги]]. ### Свойства в формате JSON Хотя мы рекомендуем использовать YAML для определения свойств, вы также можете определять свойства с помощью [JSON](https://www.json.org/): ```json --- { "tags": ["journal"], "publish": false } --- ``` Обратите внимание, что блок JSON будет прочитан, интерпретирован и сохранён в формате YAML. ## Свойства по умолчанию Obsidian поставляется с набором свойств по умолчанию: | Свойство | Тип | Описание | | ------------ | ------ | ------------------------------------------------------------------- | | `tags` | Список | См. [[Теги\|Теги]]. | | `aliases` | Список | См. [[Псевдонимы]]. | | `cssclasses` | Список | Позволяет стилизовать отдельные заметки с помощью [[CSS-сниппеты]]. | ### Свойства для Obsidian Publish Следующие свойства по умолчанию можно использовать с [[Введение в Obsidian Publish|Obsidian Publish]]: | Свойство | Описание | | ------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `publish` | См. [[Публикация контента#Автоматический выбор заметок для публикации\|Автоматический выбор заметок для публикации]]. | | `permalink` | См. [[Постоянные ссылки\|Постоянные ссылки]]. | | `description` | См. [[Превью ссылок в социальных сетях#Description\|Description]]. | | `image` | См. [[Превью ссылок в социальных сетях#Image\|Image]]. | | `cover` | См. [[Превью ссылок в социальных сетях#Image\|Image]]. | ### Устаревшие свойства Эти свойства были объявлены устаревшими в Obsidian 1.4 и должны быть заменены их современными аналогами. Поддержка их в качестве [[#Свойства по умолчанию|свойств по умолчанию]] прекращена в Obsidian 1.9. | Свойство | Описание | | ---------- | ---------------------------------------- | | `tag` | Устаревший псевдоним для `tags`. | | `alias` | Устаревший псевдоним для `aliases`. | | `cssclass` | Устаревший псевдоним для `cssclasses`. | > [!tip] Если вам нужно конвертировать файлы в вашем хранилище в формат [[#Свойства по умолчанию|свойств по умолчанию]], вы можете использовать [[Конвертер форматов]] для массового изменения хранилища.