YAML-свойства и Bases в Obsidian

Что такое YAML-свойства

В начале любого MD-файла можно добавить блок метаданных — frontmatter. Он ограничен тремя дефисами сверху и снизу:

---
title: Война и мир
author: Лев Толстой
genre: Роман
year: 1869
status: прочитано
tags:
  - классика
  - русская-литература
---

Всё, что между --- и --- — это YAML (Yet Another Markup Language). Obsidian понимает этот формат и показывает свойства в красивом виде в верхней части заметки.

Для AI-агента свойства — это структурированные данные, по которым можно фильтровать, сортировать и группировать заметки. Это как колонки в Excel, только для каждого файла.

Зачем это нужно

Без свойств заметка — просто текст. С ними — запись в базе данных.

• Поиск и фильтрация — найти все книги со статусом «читаю», все проекты с дедлайном в апреле
• Сортировка — отсортировать заметки по дате, рейтингу, статусу
• Таблицы — собрать все заметки определённого типа в одну таблицу (через Bases)
• Агенты — AI может читать свойства и принимать решения на их основе (например, «обработай все заметки, где status: draft»)
• Шаблоны — стандартизировать структуру заметок по типам

Типы свойств

Obsidian автоматически определяет тип по значению, но можно задать явно через интерфейс.

Тип	Пример	Как выглядит
Text	author: Толстой	Текстовое поле
Number	year: 1869	Числовое поле
Checkbox	finished: true	Галочка
Date	date: 2026-04-12	Календарь
Date & Time	created: 2026-04-12T14:30	Календарь + время
List	tags: [ai, obsidian]	Список значений
Aliases	aliases: [ИИ, AI]	Альтернативные имена файла

Синтаксис YAML

Простые значения

---
title: Название заметки
author: Имя автора
year: 2026
draft: true
rating: 4.5
---

Списки

Два способа записи — оба работают одинаково:

---
# Вариант 1: каждый элемент с новой строки
tags:
  - ai
  - obsidian
  - курс

# Вариант 2: в одну строку
tags: [ai, obsidian, курс]
---

Даты

Obsidian понимает формат YYYY-MM-DD:

---
date: 2026-04-12
deadline: 2026-05-01
created: 2026-04-12T14:30:00
---

Ссылки на другие заметки

Wikilinks работают и в свойствах:

---
project: "[[AI Obsidian]]"
related:
  - "[[Модуль 1]]"
  - "[[Модуль 2]]"
---

Кавычки обязательны, если значение содержит [[.

Многострочный текст

---
description: >
  Это длинное описание,
  которое будет склеено
  в одну строку.

notes: |
  Это многострочный текст,
  где переносы строк
  сохранятся.
---

> — склеивает строки в одну. | — сохраняет переносы.

Частые ошибки в YAML

Ошибка	Проблема	Решение
Нет пробела после двоеточия	title:текст	title: текст
Спецсимволы без кавычек	title: Книга: подзаголовок	title: "Книга: подзаголовок"
Табуляция вместо пробелов	YAML не поддерживает табы	Используй пробелы (2 шт.)
--- не на первой строке	Frontmatter работает только в начале файла	Ничего не должно быть выше первых ---
true/false как текст	status: true станет чекбоксом	status: "true" — в кавычках для текста

Правило: если сомневаешься — оборачивай значение в кавычки. Кавычки никогда не мешают, а их отсутствие иногда ломает.

Как редактировать свойства

В Obsidian (визуально)

В режиме Reading View или Live Preview свойства отображаются как карточка в верхней части заметки. Кликаешь на поле — редактируешь.

Чтобы добавить новое свойство:

1. Кликни на область свойств
2. Нажми «Add property» (или +)
3. Введи название и значение

В Source Mode (код)

Переключись в Source Mode (Cmd/Ctrl + E или через меню) — увидишь чистый YAML. Редактируй напрямую.

Через агента

AI-агент может редактировать YAML так же, как обычный текст:

Пожалуйста, добавь во все заметки в папке Books свойство status: "не читал",
если его там ещё нет.

Агент прочитает файлы, найдёт frontmatter, добавит свойство. Для него это просто текст.

Встроенные свойства Obsidian

Некоторые свойства Obsidian понимает «из коробки»:

Свойство	Назначение
tags	Теги заметки (видны в поиске, Graph View)
aliases	Альтернативные названия (для поиска и автодополнения [[)
cssclasses	CSS-классы для кастомного оформления заметки
publish	true/false — показывать ли при Publish

Всё остальное — твои кастомные свойства. Называй как хочешь.

Стратегия: какие свойства добавлять

Не нужно добавлять свойства ко всем заметкам. Начни с заметок одного типа — например, книги или проекты.

Для книг

---
title: Название
author: Автор
genre: Жанр
year: 2020
status: читаю
rating: 4
LLM: Claude
---

Для проектов

---
project: Название проекта
status: active
deadline: 2026-06-01
priority: high
LLM: Claude
---

Для meeting notes

---
date: 2026-04-12
type: meeting
participants:
  - "[[Иван]]"
  - "[[Мария]]"
decisions:
  - Запустить проект до мая
LLM: Claude
---

Для ежедневных заметок

---
date: 2026-04-12
energy: 7
sleep: 7.5
mood: хорошо
LLM: Claude
---

Правило для курса: каждый файл, созданный с участием AI, должен содержать LLM: Claude — это маркер того, что агент участвовал в создании.

---

Bases — встроенная база данных

Что это

Bases — встроенная функция Obsidian, которая превращает ваши заметки в таблицу с фильтрацией и сортировкой. По сути — Excel или Notion Database, только данные живут в обычных MD-файлах.

Bases работает через YAML-свойства: каждое свойство становится колонкой таблицы.

Как создать базу

1. Открой Command Palette (Cmd/Ctrl + P)
2. Введи «New base» или «Новая база»
3. Obsidian создаст файл с расширением .base
4. По умолчанию в базу попадут все заметки волта

Настройка базы

Ограничить папку

По умолчанию база покажет все 3000+ файлов. Это не то, что нужно. Ограничь источник:

1. Нажми на «Filters» (или иконку фильтра)
2. Добавь фильтр: Folder → is → выбери папку (например, Books)

Теперь база показывает только файлы из этой папки.

Добавить колонки

1. Нажми + справа от последней колонки
2. Выбери свойство из списка (например, author, genre, year)
3. Колонка появится в таблице

Порядок колонок можно менять перетаскиванием.

Фильтрация

Примеры фильтров:

Фильтр	Что покажет
genre is Научная фантастика	Только sci-fi
status is читаю	Книги в процессе
year > 2020	Книги после 2020 года
rating >= 4	С рейтингом 4 и выше
tags contains ai	Заметки с тегом ai

Фильтры комбинируются: можно добавить несколько одновременно (AND-логика).

Сортировка

1. Кликни на заголовок колонки
2. Выбери сортировку: по возрастанию или убыванию

Пример: сортировка по rating убыванию — сверху будут книги с лучшим рейтингом.

Группировка

Можно сгруппировать строки по значению свойства. Например, сгруппировать книги по genre — получишь секции: Научная фантастика, Детектив, Бизнес и т.д.

Примеры баз

Библиотека

Папка: Books
Колонки: Name, author, genre, year, status, rating
Фильтр: —
Сортировка: rating (убывание)

Активные проекты

Папка: Projects
Колонки: Name, status, deadline, priority
Фильтр: status is "active"
Сортировка: deadline (возрастание)

Прочитанные книги за 2026

Папка: Books
Колонки: Name, author, genre, rating
Фильтр: status is "прочитано" AND year is 2026
Сортировка: rating (убывание)

Люди

Папка: People
Колонки: Name, company, role, last_contact
Фильтр: —
Сортировка: last_contact (убывание)

Трекер привычек (через Daily Notes)

Папка: Daily
Колонки: Name, energy, sleep, mood
Фильтр: date >= 2026-04-01
Сортировка: date (убывание)

Режимы отображения

Bases поддерживает несколько режимов:

• Table — стандартная таблица (по умолчанию)
• List — список карточек

Переключение — через иконку в верхней части базы.

Базы и AI-агенты

Bases — это визуальный инструмент для человека. AI-агент не «видит» базу напрямую, он работает с файлами и их YAML-свойствами.

Но связка работает так:

1. Ты через Bases видишь структурированную таблицу, находишь что нужно
2. Агент через YAML-свойства может фильтровать и обрабатывать файлы программно

Например:

Найди все заметки в папке Books, где status: "не читал",
и для каждой добавь краткое описание книги в свойство description.

Агент пройдёт по файлам, прочитает YAML, найдёт нужные и обогатит их.

---

Теги vs свойства vs ссылки

Три способа связывать информацию в Obsidian. Когда что использовать:

Теги (#ai, #проект)

• Плоская структура, без иерархии значений
• Нет типизации (тег — всегда строка)
• Хорошо для: быстрой разметки на ходу, временных пометок
• Плохо для: структурированных данных, фильтрации по нескольким параметрам

Свойства (YAML)

• Типизированные данные (текст, число, дата, список)
• Работают с Bases — фильтрация, сортировка, группировка
• Хорошо для: каталогов (книги, контакты, проекты), мета-информации
• Плохо для: связей между заметками

Ссылки ([[Заметка]])

• Двусторонние связи между заметками
• Видны в Graph View
• AI-агент понимает контекст связей
• Хорошо для: смысловых связей (этот проект → этот клиент), навигации
• Плохо для: массовой фильтрации

Рекомендация

Используй все три, но для разных целей:

---
# Свойства — структурированные данные
type: book
author: Толстой
status: прочитано
rating: 5

# Теги — быстрая разметка
tags:
  - классика
---

# Ссылки — смысловые связи
Эта книга повлияла на [[Мой проект]] и связана с [[Заметка о русской литературе]].

---

Массовое добавление свойств через агента

Самое мощное применение YAML + AI — массовая обработка. Примеры промптов:

Добавить свойства ко всем файлам в папке

Пройди по всем файлам в папке Books.
Если у файла нет YAML frontmatter — добавь.
Если нет свойства "status" — добавь status: "не читал".
Если нет свойства "LLM" — добавь LLM: Claude.
Не меняй существующие свойства.

Обогатить свойства данными

Пройди по файлам в Books, у которых пустое свойство "genre".
Прочитай содержимое заметки и определи жанр книги.
Запиши жанр в свойство genre.

Конвертировать теги в свойства

В папке Projects найди все файлы с тегом #active.
Удали этот тег и вместо него добавь YAML-свойство status: active.

Создать связи на основе свойств

Найди все книги, где author: "Толстой".
В каждой добавь ссылку [[Лев Толстой]] в конец файла,
если её там ещё нет.

---

Шпаргалка

YAML

---
# Текст
title: "Название"

# Число
year: 2026

# Булево
draft: false

# Дата
date: 2026-04-12

# Список
tags:
  - один
  - два

# Ссылка
project: "[[Мой проект]]"
---

Bases

1. Cmd/Ctrl + P → «New base»
2. Добавь фильтр по папке
3. Добавь колонки (свойства)
4. Настрой фильтры и сортировку
5. Готово — у тебя таблица из заметок

Правило на каждый день

Когда создаёшь новую заметку — подумай на 2 секунды: какие свойства пригодятся через месяц? Добавь их сейчас. Потом спасибо скажешь.