Полный гайд по Obsidian и Markdown

Что такое Obsidian и зачем Markdown

Obsidian — приложение для заметок, которое хранит всё в обычных текстовых файлах формата Markdown. Никаких проприетарных форматов, никаких баз данных, никакой зависимости от сервиса. Закрылся Notion — потерял заметки. Закрылся Obsidian — у тебя папка с файлами, открывай чем хочешь.

Но главное для нашего курса: Markdown — это язык, который одинаково хорошо читают и люди, и LLM. Когда ты пишешь заметку в Obsidian, ты одновременно создаёшь контекст, который AI-агент может прочитать, понять и использовать. Это не PDF с потерянным форматированием, не скриншот, который нужно распознавать, не вложение в чате, которое исчезнет завтра — это структурированный текст с заголовками, списками и ссылками. Для AI это идеальный формат входных данных.

Obsidian бесплатен. Есть платная синхронизация ($4/мес) и публикация ($8/мес), но для курса они не нужны — всё работает локально.

Установка

macOS:

Скачай .dmg с obsidian.md
Открой .dmg и перетащи Obsidian в папку Applications
При первом запуске macOS может попросить подтвердить запуск — нажми "Открыть"
Если macOS блокирует: System Settings → Privacy & Security → "Open Anyway"

Windows:

Скачай .exe с obsidian.md
Запусти установщик, прокликай стандартные шаги
Obsidian появится в меню "Пуск"

Linux: Доступен AppImage, Snap и Flatpak. AppImage — самый универсальный: скачал, дал права на выполнение, запустил.

Мобильные устройства: iOS и Android — есть в App Store и Google Play. Полноценный Obsidian, не урезанная версия. Для синхронизации между устройствами можно использовать Obsidian Sync (платный), iCloud (для Apple) или Syncthing (бесплатный, кроссплатформенный).

Создание хранилища (vault)

При первом запуске выбери "Create new vault". Дай имя (например, "Brain", "Base" или "Notes") и укажи папку. Рекомендация: создай в домашней директории или в Documents. Не на рабочем столе — будет мешать, и легко случайно удалить.

Хранилище — это просто папка на диске. Внутри — файлы .md и подпапки. Можно открыть в любом текстовом редакторе (VS Code, Sublime, даже Блокнот). Можно положить в git для версионирования. Можно синхронизировать через облако. Obsidian работает поверх обычной файловой системы — никакой магии.

Один важный момент: Obsidian создаёт скрытую папку .obsidian внутри хранилища. Там хранятся настройки, плагины и темы. Не удаляй её, но и не переживай о её содержимом — это служебные файлы.

Markdown: всё, что нужно знать

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

Заголовки

# Заголовок 1 (название заметки, один на файл)
## Заголовок 2 (основной раздел)
### Заголовок 3 (подраздел)
#### Заголовок 4 (используется редко)

Используй заголовки для структуры, а не для "красоты". AI-агенты ориентируются по заголовкам, когда ищут нужный фрагмент в заметке. Хороший заголовок = быстрая навигация для тебя и для AI.

Правило: один # на файл (название заметки), дальше ## для разделов. Не пропускай уровни (не прыгай с # на ###).

Списки

- Ненумерованный
- Список
  - Вложенный элемент
  - Ещё один
- Элементов

1. Нумерованный
2. Список
3. Порядок важен
   1. Вложенная нумерация
   2. Тоже работает

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

Выделение текста

**Жирный текст** — для ключевых идей и терминов
*Курсив* — для акцентов и иностранных слов
~~Зачёркнутый~~ — для устаревшего или отменённого
`Код` — для команд, переменных и технических терминов
==Выделение== — подсветка текста (работает в Obsidian, не стандартный Markdown)

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

Ссылки между заметками (wikilinks)

[[Название заметки]]
[[Название заметки|Отображаемый текст]]
[[Название заметки#Конкретный раздел]]

Двойные квадратные скобки — главная суперсила Obsidian. Они создают связи между заметками, формируя сеть знаний. Начни набирать [[ — Obsidian покажет автодополнение со списком существующих заметок.

Можно ссылаться на несуществующие заметки. Они станут "фантомными" — будут видны в графе как несозданные точки. Когда создашь заметку с таким названием, связь подключится автоматически. Это мощный приём: ссылайся на то, что пока не написал, и создавай заметки по мере необходимости.

Внешние ссылки работают как в обычном Markdown:

[Текст ссылки](https://example.com)

Блоки кода

Встроенный код: `console.log("hello")`

Блок кода с подсветкой синтаксиса:
```python
def greet(name):
    return f"Hello, {name}"
```

```sql
SELECT * FROM users WHERE active = true
```

Блоки кода полезны не только для программистов. Храни в них промпты для AI, конфигурации, SQL-запросы, команды терминала — всё, что нужно копировать точно, без изменений.

Чек-боксы (задачи)

- [ ] Задача не выполнена
- [x] Задача выполнена
- [ ] Ещё одна задача

Obsidian позволяет кликать по чек-боксам прямо в режиме просмотра. Плагин Dataview может собирать незавершённые задачи из всех заметок в один список — мощный инструмент для трекинга дел.

Цитаты и выноски

> Это цитата. Полезно для выделения чужих мыслей или важных выводов.

> [!tip] Полезный совет
> Выноски (callouts) — фича Obsidian для визуального выделения блоков.
> Типы: tip, warning, note, example, quote и другие.

YAML-метаданные (frontmatter)

В самом начале заметки (до любого текста) можно добавить метаданные:

---
tags:
  - проект
  - ai
date: 2026-03-29
status: active
author: Max
---

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

Не перегружай frontmatter на старте. Начни с tags и date — остальное добавишь, когда поймёшь, что нужно.

Разделители и переносы

---       (горизонтальная линия)
\         (принудительный перенос строки)

Пустая строка создаёт новый абзац. Одиночный перенос строки Markdown по умолчанию игнорирует.

💬 Промпт для LLM: Скопируй и вставь в Claude или ChatGPT:

Я учу markdown. Вот мой текст: [вставь текст]. Переформатируй его в правильный markdown с заголовками, списками и выделением ключевых мыслей. Объясни каждое изменение, которое ты сделал.

Структура папок для старта

Не усложняй. Начни с пяти папок и расширяй по мере необходимости:

Input/       — входящие, необработанные заметки
Projects/    — активные проекты, по папке на проект
Knowledge/   — постоянные заметки, организованные по темам
Daily/       — ежедневные записи
Templates/   — шаблоны для повторяющихся типов заметок

Input/ — сюда складываешь всё, что прилетело: идея в душе, цитата из книги, ссылка из Telegram, мысль после встречи. Не обрабатывай сразу — просто зафиксируй. Раз в неделю (или когда накопится) разбирай: что-то уйдёт в Projects, что-то в Knowledge, что-то удалишь.

Projects/ — папка на каждый активный проект. Внутри — заметки, связанные с проектом: план, встречи, идеи, ресурсы. Завершил проект — можно перенести в Archive/ (создашь, когда понадобится).

Knowledge/ — атомарные заметки. Одна идея — одна заметка. "Как работает compound interest", "Принцип инверсии зависимостей", "Почему ретроспективы не работают". Ссылки между ними создают сеть знаний — самую ценную часть хранилища.

Daily/ — ежедневные заметки. Формат имени файла: 2026-03-29.md. Что сделал, что думаешь, что планируешь. Не дневник, а рабочий лог. Со временем ежедневные заметки становятся бесценным архивом: "что я делал в марте?" — открыл папку и посмотрел.

Templates/ — заготовки, чтобы не начинать с чистого листа. Шаблон ежедневной заметки, шаблон заметки о встрече, шаблон проекта.

Теги, папки и ссылки — когда что использовать

Три инструмента организации. Каждый для своего:

Папки — жёсткая иерархия. Заметка живёт в одной папке. Используй для крупных категорий: тип контента (Projects, Knowledge, Daily) или область жизни (Work, Personal, Learning). Не создавай глубокую вложенность — два уровня максимум.

Теги — гибкие метки, пересекающие папки. #идея, #срочно, #ai, #книга. Заметка может иметь сколько угодно тегов. Используй для свойств и характеристик: статус, тема, приоритет. Теги можно вкладывать: #проект/активный, #проект/завершён.

Ссылки [[]] — смысловые связи. "Эта заметка связана с той". Самый мощный инструмент из трёх. Ссылки формируют граф знаний, который со временем показывает, как связаны твои идеи, проекты и области знаний.

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

💬 Промпт для LLM: Скопируй и вставь в Claude или ChatGPT:

Я [моя роль]. Мои основные активности: [перечисли 3-5 активностей]. Предложи структуру папок для моего Obsidian vault. Для каждой папки объясни, что в ней будет храниться.

Граф (Graph View)

Открой через Cmd/Ctrl+G или через боковую панель (значок точек с линиями). Граф показывает все заметки как точки (nodes) и все ссылки между ними как линии (edges).

На старте граф выглядит пусто и скучно. Это нормально. Через пару месяцев активного использования он превращается в карту твоего мышления. Кластеры точек — области знаний. Заметки-хабы с множеством связей — ключевые концепции. Изолированные точки — заметки, которые стоит связать или удалить.

Граф полезен не для красоты (хотя он красивый), а для обнаружения неочевидных связей. Две заметки из разных областей связаны через третью? Это сигнал: стоит подумать, есть ли пересечение, которое ты не замечал.

Локальный граф (Local Graph, тоже через боковую панель) показывает связи только для текущей заметки — удобно для навигации по ближайшему контексту.

Шаблоны

Шаблоны экономят время и обеспечивают единообразие. Создай папку Templates/ и положи туда заготовки.

Пример: шаблон для заметки о встрече:

---
tags:
  - meeting
date: {{date}}
participants:
---

# Встреча: {{title}}

## Контекст
Зачем встречались, предыстория.

## Ключевые решения
-

## Открытые вопросы
-

## Следующие шаги
- [ ]
- [ ]

Пример: шаблон ежедневной заметки:

---
date: {{date}}
tags:
  - daily
---

# {{date}}

## Фокус дня
-

## Заметки
-

## Итоги
-

Для автоматической подстановки дат и выбора шаблонов используй плагин Templater. Встроенные шаблоны Obsidian тоже работают, но Templater значительно мощнее: переменные, условия, JavaScript-вставки.

Настройка встроенных шаблонов: Settings → Core Plugins → Templates → включить → указать папку Templates.

💬 Промпт для LLM: Скопируй и вставь в Claude или ChatGPT:

Создай для меня 3 шаблона Obsidian-заметок в формате markdown с YAML frontmatter: 1) шаблон для встречи, 2) шаблон для книги/статьи, 3) шаблон для идеи проекта. Каждый шаблон должен содержать [заполняемые поля].

Горячие клавиши

Запомни четыре — остальное доберёшь по мере использования:

Действие	Mac	Windows/Linux
Быстрое открытие заметки	Cmd+O	Ctrl+O
Палитра команд	Cmd+P	Ctrl+P
Переключить режим правки/просмотра	Cmd+E	Ctrl+E
Создать новую заметку	Cmd+N	Ctrl+N

Палитра команд (Cmd/Ctrl+P) — самая полезная. Через неё можно выполнить любую команду Obsidian, не запоминая отдельные хоткеи. Начни набирать название действия — найдётся.

Быстрое открытие (Cmd/Ctrl+O) — мгновенный поиск по названиям заметок. Быстрее, чем искать файл в папке. Печатаешь часть названия — заметка открывается.

Дополнительные хоткеи, которые пригодятся позже:

Действие	Mac	Windows/Linux
Поиск по содержимому	Cmd+Shift+F	Ctrl+Shift+F
Граф	Cmd+G	Ctrl+G
Открыть настройки	Cmd+,	Ctrl+,
Разделить экран	Cmd+\	Ctrl+\

Что дальше

Твоё хранилище готово. Структурированные заметки в Markdown, связанные ссылками, с метаданными в YAML, организованные по папкам. Это именно тот фундамент, который нужен AI-агентам для работы с твоим контекстом.

На следующем шаге мы подключим к этому хранилищу Claude и другие AI-инструменты — и заметки перестанут быть просто текстом, а станут рабочей памятью твоего AI-ассистента.

Курс AI Obsidian — 3 недели, 9 встреч, максимум 32 человека

Записаться →

Полный гайд по Obsidian и Markdown

Что такое Obsidian и зачем Markdown

Установка

Создание хранилища (vault)

Markdown: всё, что нужно знать

Заголовки

Списки

Выделение текста

Ссылки между заметками (wikilinks)

Блоки кода

Чек-боксы (задачи)

Цитаты и выноски

YAML-метаданные (frontmatter)

Разделители и переносы

Структура папок для старта

Теги, папки и ссылки — когда что использовать

Граф (Graph View)

Шаблоны

Горячие клавиши

Рекомендованные плагины для старта

Что дальше