Structure Commander

Плагин Obsidian для управления многоуровневой Markdown-структурой: перемещение веток, повышение и понижение уровня (включая преобразования между текстом, заголовками и списками), сворачивание/разворачивание, перенумерация, экспорт ветки, боковая панель и узкая панель инструментов над редактором.

Назначение

Плагин превращает заголовки документа в управляемое дерево. Удобно работать с длинными заметками, ТЗ, конспектами, документацией: переставлять разделы, менять глубину иерархии, быстро сворачивать/разворачивать ветки, экспортировать отдельные подразделы в самостоятельные заметки.

Команды

Все команды доступны через палитру Ctrl+P. Названия команд начинаются с Structure Commander.

Хоткеи по умолчанию

Хоткеи Alt+←/→ выбраны намеренно вместо Ctrl+Shift+←/→: последние конфликтуют со стандартным выделением текста по словам в любом текстовом поле.

Изменить хоткеи: Настройки → Hotkeys, ищите Structure. В настройках плагина есть кнопка Открыть Hotkeys.

Панель инструментов над редактором

Над Markdown-редактором есть узкая горизонтальная панель:

[↑] [↓] [←] [→] [−] [+] [Показать: H1 ▾] [H? ▾] [№]

В tooltip на кнопках показано действие и текущий хоткей. ПКМ по кнопке открывает меню с пунктом «Назначить хоткей» — это всплывающее окно, в котором достаточно нажать желаемую комбинацию клавиш (включая Numpad1..9, F1..F12, любые модификаторы), и плагин сразу её сохранит. Можно также очистить хоткей или открыть штатный редактор Obsidian.

Все выпадающие меню тулбара (Показать ▾, Hn ▾, ПКМ по №) показывают рядом с пунктами их текущие хоткеи, если хоткей назначен.

Кнопка × справа на тулбаре скрывает его. Вернуть тулбар: команда Скрыть/показать панель инструментов над редактором (или галка в настройках плагина).

Когда курсор стоит вне ветки заголовков, кнопки операций над веткой подсвечены приглушённо.

Если не нужна — отключается в настройках плагина.

Контекстное меню редактора (ПКМ)

ПКМ в Markdown-редакторе добавляет в контекстное меню несколько верхнеуровневых пунктов с подменю:

Развернуть/свернуть ▸
   ├─ Развернуть      Alt+→
   ├─ Свернуть        Alt+←
   └─ Показать/скрыть панель структуры

Показать до ▸  H1, H2, …, Показать всё
   (только реально существующие в документе уровни)

Уровень | Перенос ▸
   ├─ Повысить        Alt+Shift+←
   ├─ Понизить        Alt+Shift+→
   ├─ Вверх           Alt+Shift+↑
   ├─ Вниз            Alt+Shift+↓
   ├─ Понизить до ▸   H2, H3, … (вся ветка с сохранением иерархии)
   └─ Повысить до ▸   H1, H2, … (вся ветка с сохранением иерархии)

Нумерация ▸  Перенумеровать, Удалить, Emoji, Исправить пропуски

Экспорт ветки…

В подменю «Понизить до» / «Повысить до» — только те уровни, при сдвиге к которым ни один заголовок ветки не выйдет за пределы H1…H6.

Повысить / Понизить универсальны: работают и на заголовке (вся ветка), и на обычном тексте (текст → H6 / текст → список), и на маркированном списке (список → текст).

Боковая панель

Команды:

• Открыть боковую панель структуры справа
• Открыть боковую панель структуры слева
• Открыть боковую панель структуры снизу
• Скрыть/показать боковую панель структуры (можно повесить хоткей)

В панели:

• поиск по заголовкам;
• фильтр глубины (До H1 … До H6, Все);
• счётчик видно / всего;
• подсветка текущего заголовка (по позиции курсора в активном редакторе);
• кнопка × в шапке скрывает панель;
• ПКМ по пункту: Перейти, свернуть/развернуть, переместить выше/ниже, повысить/понизить, экспорт.

Уровень заголовка в панели передаётся визуально — отступом, жирностью, наклоном и цветом текста. Подписи H1, H2 намеренно не дублируются в каждой строке.

Панель обновляется при смене активного файла, при изменении файла, при смене активного редактора. Чтение файла защищено от устаревших async-результатов и работает с debounce (≈220 мс).

Экспорт ветки

Окно экспорта:

• куда сохранить: рядом с текущей заметкой / в указанную папку / спрашивать каждый раз;
• папка по умолчанию: _Exports;
• чекбокс «Открыть файл после экспорта» (по умолчанию выключен);
• чекбокс «Привести корневой заголовок к H1» — при экспорте сдвигает уровни так, чтобы корень стал H1;
• имя файла берётся из заголовка корня ветки, запрещённые символы вычищаются;
• при коллизии добавляется суффикс 2, 3, 4 …;
• последний выбор запоминается, Enter повторяет.

Перенумерация

Окно перенумерации:

• область: весь документ / текущая ветка / выделенный фрагмент;
• что менять: только заголовки / только списки / заголовки и списки;
• стиль: 1. / 1.1. или 1️⃣ / 1️⃣.1️⃣;
• предпросмотр: первые 8 изменений в виде было → станет;
• сводка Будет изменено строк: N.

Применение — одной транзакцией. Курсор и позиция скролла сохраняются. Ctrl+Z откатывает всю операцию одним действием.

Транзакционность

Все массовые изменения (перемещение ветки, повышение/понижение, нормализация, перенумерация, удаление нумерации, emoji-цифры) применяются одной транзакцией редактора — Ctrl+Z откатывает каждую операцию одним действием.

moveBlock переписан так, чтобы:

• корректно работать на первой и последней ветке;
• корректно работать на файле без финального перевода строки;
• не создавать лишних пустых строк;
• не склеивать заголовки.

Ограничения

• Markdown поддерживает только заголовки H1 … H6.
• Плагин работает с ATX-заголовками: #, ##, ###, …
• Setext-заголовки (с подчёркиванием === / ---) не поддерживаются.
• Заголовки внутри fenced code blocks (``` или ~~~) игнорируются.
• Глобальные хоткеи Windows / macOS / других приложений изнутри Obsidian проверить нельзя — коллизии с системными или сторонними хоткеями плагин не покажет, только коллизии внутри Obsidian.
• При использовании Alt+←/→ для свёртывания: на macOS Alt это Option — учитывайте раскладки клавиатуры.

Установка

1. Закрыть Obsidian.
2. Скопировать папку structure-commander в .obsidian/plugins/ хранилища.
3. Проверить структуру файлов:

.obsidian/plugins/structure-commander/manifest.json
.obsidian/plugins/structure-commander/main.js
.obsidian/plugins/structure-commander/styles.css

4. Открыть Obsidian.
5. Настройки → Community plugins → включить Structure Commander.

Совместимость

minAppVersion: 1.0.0. Тестировалось с актуальными десктопными сборками Obsidian. На мобильных Obsidian панель инструментов над редактором тоже работает, но физических хоткеев на телефоне нет — пользуйтесь верхней панелью и подменю ПКМ.