Перейти к содержимому
Авторский вебсайт. Ошибки и проблемы гарантированы❗
Киберинженерия
Инженерия
Obsidian
Интерфейс
Редактор

Команды редактора

Назначение редактора

Редактор приложения Obsidian предназначен:

  • для набора гипертекста из символов и вложений;
  • для разметки структуры гипертекста.

Базовая сборка

В архитектуре редактора Obsidian понятия «плагины» (Plugins) и «расширения» (Extensions) являются базовыми строительными блоками. После установки Obsidian редактор содержит лишь «базовую сборку». Далее пользователь самостоятельно выбирает как встроенные, так и сторонние плагины для адаптации редактора к своим потребностям действий.

Для обеспечения доступности редактор сразу же после установки приложения Obsidian готов к работе. Начальную доступность и работоспособность редактора обеспечивает базовая сборка действий, которая позволяет:

Управлять сочетаниями клавиш

Редактор поддерживает управление вводом текста с помощью клавиатуры, мыши и сенсорного экрана устройства пользователя.

Примечание

Полный список сочетаний клавиш, применяемых графическим интерфейсом редактора, смотрите в отдельном справочнике.

Редактор предлагает продвинутые возможности навигации. Например:

  • Перемещение по словам. Сочетание клавиш Ctrl + ← или Ctrl + → для быстрого перемещения курсора между целыми словами.
  • Перемещение в начало или в конец заметки. Сочетание клавиш Ctrl+Home или Ctrl+End.
  • Удаление слов. Сочетание клавиш Ctrl+Backspace удаляет слово целиком слева от курсора, а сочетание Ctrl+Delete удаляет слово справа от курсора.
  • Удаление строки. Сочетание клавиш Ctrl+D удаляет текущую строку, на которой расположен курсор.

Нумеровать строки

Полоса (Gutter) — вертикальная полоса редактора, расположенная вдоль текста слева.

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

Настройка нумерации строк: Settings (Настройки) → Editor (Редактор) → Line numbers (Нумеровать строки).

Для включения полосы в левом или правом поле нажать правую кнопку мыши. Во всплывающем меню выбрать интересующие настройки:

  • Readable line length (Читаемая длина строки);
  • Line numbers (Нумерация строк);
  • Inline title (Встроенный заголовок).

Подсвечивать синтаксис

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

По умолчанию редактор поддерживает парсинг следующих языков программирования: Angular, CSS, C++, Go, HTML, Java, JavaScript, Jinja, JSON, Liquid, Markdown, PHP, Python, Rust, Sass, SQL, Vue, WAST, XML, YAML. Сообщество поддерживает парсинг множества других языков программирования.

С помощью парсинга редактор позволяет:

  • применять цветовые схемы отображения текста на соответствующем языке;
  • добавлять правила подсветки;
  • настраивать отступы;
  • сворачивать разделы.

Вести историю изменений

Приложение Obsidian запоминает историю всех изменений гипертекста заметки. Это позволяет вернуть любое из предыдущих изменений. В процессе редактирования для этого используют:

  • сочетание клавиш <Ctrl+Z> или команду Undo (Откатить) для отмены последнего действия;
  • сочетание клавиш Ctrl+Y, Ctrl+Shift+Z или команду Redo (Повторить) для повтора действия.

Сворачивать блоки текста

Редактор анализирует структуру заметки, выявляет границы сворачивания блока (Code Folding). Это позволяет редактору сворачивать и разворачивать отдельные разделы или блоки текста.

Перед заголовками всплывают символы шеврона (свернуть) или (развернуть).

Управлять отступами

Редактор аккуратно оперирует синтаксисом автоматически определяет размер отступов при создании или переносе строки. При нажатии клавиши Tab редактор смещает строку текста на заданное количество символов пробела (отступ). При нажатии клавиши Enter редактор автоматически переносит курсор на новую строку с сохранением уровня отступа. Например, внутри списков или вложенного кода.

Редактор позволяет включить в настройках и отображать направляющие линии отступов.

Управлять скобками

Редактор поддерживает сопоставление скобок (Bracket matching). Он подсвечивает парную скобку, если курсор установлен на другой скобке. Существуют следующие применения парных скобок:

  • Оборачивание. Если выделить фрагмент, а затем набрать любую из скобок [, {, ( или кавычек ", ', `, то редактор не удалит выделенный текст, а автоматически обернёт этот фрагмент парными символами. Закрывающий символ всегда расположен перед пробелом. По умолчанию закрывающие символы:  )]}:;>.
  • Создание ссылок. Если выделить фрагмент текста, а затем ввести квадратную скобку [, редактор оформит этот текст как внутреннюю (вики) ссылку [[заметка]]. Если скопировать в браузере ссылку URL, а затем выделить в заметке фрагмент текста и нажать сочетание клавиш Ctrl + V — редактор автоматически создаст стандартную ссылку Markdown формата [заметка](url).

Автодополнять

Редактор поддерживает автоматическое дополнение — подсказки, зависящие от языка текста. Встроенная генерация контекстных подсказок обеспечивает оБрисовку выпадающего списка (Dropdown Tooltip) рядом с курсором. Например:

  • Ввод двойной квадратной скобки [[ открывает графическое меню со списком всех существующих заметок. Это удобно для быстрого установления отношений между заметками.
  • Ввод решётки # внутри текста, а не в начале строки, открывает список существующих тегов.
  • Если установлены плагины вроде Dataview, ввод двойного двоеточия :: предлагает автодополнение метаданных.

Перемещать курсор по выпадающим при автодополнении спискам можно с помощью клавиш вверх-вниз ↑ и ↓. Подтверждать выбор — клавишами Enter или Tab.

Редактор на лету распознаёт и правильно оформляет разметку Markdown. Например, если:

  • Выделить слово, а затем нажать сочетание Ctrl + B. Редактор автоматически разметит текст в виде **курсор**.
  • Выделить слово, а затем нажать сочетание Ctrl + I. Редактор автоматически разметит текст в виде *курсор*.
  • Ввести перед словом от 1 до 6 символов решётки #. Редактор разметит заголовок и визуально увеличит размер шрифта в строке в зависимости от уровня заголовка (# H1, ## H2, ### H3).
  • Ввести дефис - и пробел перед словом. Редактор разметит строку списка и установит соответствующий отступ.
  • Ввести дефис и пару квадратных скобок - [ ]. Редактор разметит пустой проверочный список. Список интерактивный, если в тексте нажать на пробел внутри квадратных скобок, редактор заметит набор символов на - [x].

Выбрать фрагмент текста

Фрагмент (chunk) — диапазон изменённых редактором строк.

Одно из ключевых удобств редактора — обработка фрагментов текста. Изменения происходят внутри фрагмента. Позицию изменения измеряют от начала (первого символа) фрагмента.

Редактор позволяет:

  • выбирать как горизонтальные, так и вертикальные фрагменты текста;
  • переходить между фрагментами (выбранными для изменения строками);
  • осуществлять множественный выбор и одновременное редактирование фрагментов.

Горизонтальный выбор фрагмента текста:

  • Выбирать по символам. Зажать клавишу Shift. Стрелками влево или вправо выбирать символы. Выбранная строка символов будет подсвечена фоновым цветом.
  • Выбирать по словам. Зажать сочетание клавиш Ctrl+Shift. Стрелками влево или вправо выбирать слова. Выбранная строка слов будет подсвечена фоновым цветом.

Вертикальное выделение фрагмента текста (Rectangular Selection). Если зажать клавиши Shift + Alt, а затем мышью потянуть вниз, это позволит выделить вертикальный столбец текста. Это особенно удобно при копировании фрагментов таблиц.

Множественный выбор и редактирование фрагментов текста. Зажать клавишу Alt и мышью расставить курсоры в тексте, указывая фрагменты для изменения. Это позволяет редактировать одновременно все указанные фрагменты.

Множественный выбор работает и в файловом менеджере (проводнике) панели навигации (левой боковой панели):

  • Выбор смежных заметок. Если нажать клавишу Shift, затем указать первую и последнюю заметку, то редакторы выделит все заметки между ними. Фоновая подсветка покажет весь выбранный список. Далее можно провести операции со всем блоком (открыть все заметки, перенести заметки в другую папку).
  • Выбор несмежных заметок. Для выбора несмежных заметок следует нажать клавишу Ctrl, а затем последовательно одну за другой в произвольном порядке указать заметки. Фоновая подсветка покажет выбранные заметки. Далее можно осуществить пакетную операцию со всеми выбранными заметками.
  • Пакетная обработка. После того, как выбран список заметок, можно нажать правую кнопку мыши и в диалоговом меню выбрать подходящую операцию.

Массовое редактирование фрагментов текста:

  • Множественные курсоры (Multiple Cursors). Если выделить в тексте несколько фрагментов текста, то редактор позволяет дописывать или удалять текст в нескольких местах одновременно. Для множественного выбора следует зажать клавишу Alt, а затем мышью выделить текст в разных местах заметки.
  • Массовая отмена выделения (Remove Selections). Достаточно нажать клавишу Esc или ткнуть мышью в любое место текста, чтобы отменить множественный выбор фрагментов.

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

Панель поиска позволяет:

  • проводить поиск строк по тексту;
  • использовать в поисковом запросе регулярное выражение (RegEx);
  • подсвечивать все найденные совпадения в заметке.

Встроенную поисковую панель пользователь активирует сочетанием клавиш Ctrl+F. Панель возникает в верхней части над текстом заметки.

Панель замены позволяет находить и заменять найденное соответствие (Replace или Replace All). Встроенную панель замены пользователь активирует сочетанием клавиш Ctrl+H. Панель возникает в верхней части над текстом заметки.

Управлять строками

Редактор позволяет управлять строками:

  • разделить фрагмент на несколько строк;
  • перемещать строки списка;
  • комментировать строки.

Для перемещения строк списка используют сочетания клавиш:

  • перемещение вверх Ctrl+Alt+↑;
  • перемещение вниз Ctrl+Alt+↓.

Если в очередной версии Obsidian не установлено сочетание клавиш, то следует в настройках

  1. Перейти в раздел Settings (Настройки) → Hotkey (Сочетания клавиш).
  2. В строке поиска ввести команду «Move line up».
  3. Нажать на кнопку .
  4. Назначить для команды сочетание клавиш Ctrl+Alt+↑.
  5. В строке поиска ввести команду «Move line down».
  6. Нажать на кнопку .
  7. Назначить для команды сочетание клавиш Ctrl+Alt+↓.

Для того, чтобы закомментировать строку в синтаксисе Obsidian, следует выделить строку и нажать сочетание клавиш Ctrl+/.

Внимание!

Другие диалекты Markdown не воспринимают комментарий Obsidian. И вместо сокрытия отображают комментарий как есть в виде %%комментарий%%.

Конвертировать HTML в Markdown

Для того, чтобы настроить конвертацию HTML в Markdown: Settings (Настройки) → Editor (Редактор) → Convert pasted HTML to Markdown (Конвертировать HTML в Markdown).

При копировании (Ctrl+V) фрагмента текста в разметке HTML в заметку редактор автоматически производит конвертацию этого фрагмента в разметку Markdown.

Для копирования без разметки HTML и без автоматической конвертации следует использовать сочетание клавиш (Ctrl+Shift+V).

Диагностировать ошибки

Диагностика (Diagnostic) — поиск ошибок во фрагменте кода.

Редактор проверяет качество кода прямо во время ввода текста:

  • подсвечивает синтаксические ошибки кода или разметки Markdown;
  • выводит всплывающие окна с описанием ошибки.

Комадна диагностики (Linter) показывает уровень серьёзности ошибки:

  • error — ошибка;
  • hint — совет;
  • info — примечание, дополнительные сведения;
  • warning — предупреждение.

В режиме диагностики редактор открывает вертикальную полосу (Lint Gutter) в которую добавляет маркеры для строк, содержащих ошибки. При наведении курсора на маркер всплывает сообщение диагностики.

Привязать сочетания клавиш Vim

Для настройки привязки сочетаний клавиш редактора Vim: Settings (Настройки) → Editor (Редактор) → Advanced (Дополнительно) → Vim key bindings (Привязать сочетания Vim)

Настроить редактор

Полная настройка редактора выглядит следующим образом.

Общие настройки редактора

Установить язык интерфейса редактора Settings (Настройки) → General (Общие) → Language (Язык).

Настроить шрифт интерфейса в пункте Settings (Настройки) → Appearance (Внешний вид) → Font (Шрифт) → Interface font (Шрифт интерфейса).

Настроить шрифт текста в пункте Settings (Настройки) → Appearance (Внешний вид) → Font (Шрифт) → Text font (Шрифт текста).

Настроить шрифт блоков кода в пункте Settings (Настройки) → Appearance (Внешний вид) → Font (Шрифт) → Monospace font (Моноширинный шрифт).

Настроить размер шрифта, применяемого для редактирования и представления основного текста в пункте Settings (Настройки) → Appearance (Внешний вид) → Font (Шрифт) → Font size (Размер шрифта).

Включить или отключить быстрое изменение размера шрифта в пункте Settings (Настройки) → Appearance (Внешний вид) → Font (Шрифт) → Quick font size adjustment (Изменить размер шрифта).

Установить режим представления по умолчанию открываемой во вкладке заметки.

  1. Перейти в пункт Settings (Настройки) → Editor (Редктор) → Defaul view for new tabs (Режим представления по умолчанию).
  2. Выбрать либо режим редактирования (Editing view), либо режим просмотра (Reading view).

Установить режим редактирования по умолчанию для открываемой во вкладке заметки.

  1. Перейти в пункт Settings (Настройки) → Editor (Редактор) → Default editing mode (Режим редактирования).
  2. Выбрать либо динамический режим редактирования с просмотром (Live Preview), либо режим редактирования разметки (Source mode).

Добавить кнопку переключения режимов на панель статуса. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Show editing mode in status bar (Показать режим в панели статуса).

Настроить представление

Указать максимальную длину строки в режиме чтения. Несмотря на то, что видимая часть не вмещает всю длинную строку, текст легче просматривать. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Display (Представление) → Readable line length (Длина читаемой строки)

Указать строгий перенос строк. Если включить тумблер, то нажатие клавиши Enter будет соответствовать стандарту Markdown. Если выключить тумблер, то поведение как у обычного текстового редактора. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Display (Представление) → Strict line breaks (Строгий перенос строк).

Включить или выключить сворачивание блоков текста. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Display (Представление) → Fold heading (Сворачивать заголовки).

Включить или выключить сворачивание пунктов списка. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Fold indent (Сворачивать список).

Включить или выключить нумерацию строк. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Display (Представление) → Fold indent (Сворачивать список).

Включить или выключить направляющие линии отступов. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Display (Представление) → Identation guides (Линии отступов).

Включить или выключить отображение схем Mermaid в заметках. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Display (Представление) → Show Mermaid in notes (Показать схемы в заметках).

Настроить действия

Включить или выключить проверку орфографии.

  1. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Spellcheck (Проверить орфографию).
  2. Указать язык проверки орфографии в выпадающем списке Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Spellcheck languages (Язык проверки).

Включить или выключить автоматическое добавление парной скобки. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Auto-pair brachets (Парные скобки).

Включить или выключить автоматическое добавление парного синтаксиса Markdown. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Auto-pair Markdown syntax (Парный синтаксис Markdown).

Включить или выключить автоматическое добавление отступов в списке. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Smart lists (Отступы списка).

Включить или выключить табуляцию для отступов. Рекомендую выключить табуляцию и позволить редактору устанавливать для отступа необходимое количество пробелов (по умолчанию 4 пробела). Выключить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Indent using tabs (Табуляция).

Указать количество пробелов для визуализации отступа. Рекомендую оставить 4 пробела, указанные по умолчанию в пункте Settings (Настройки) → Editor (Редактор) → Behavior (Действия) → Indent visual width (Ширина отступа).

Команды косой черты

Для редактирования гипертекста заметки пользователь использует два вида меню:

  • контекстное меню, которое можно вызвать правой кнопкой мыши в пределах гипертекста заметки;
  • команды, вызываемые символом косой черты (/).

Для настройки команд косой черты (/) нужно включить в настройках: Settings (Настройки) → Core plugins (Встроенные плагины) → Slash commands (Команды косой черты).

Дополнительные настройки

Включить или выключить конвертацию в синтаксис Markdown при копировании фрагмента текста в разметке HTML. Включить тумблер в пункте Settings (Настройки) → Editor (Редактор) → Advanced (Дополнительно) → Convert pasted HTML to Markdown (Конвертировать HTML в Markdown).

Пользователи, которым привычны сочетания клавиш редактора Vim, могут включить эти сочетания тумблером в пункте Settings (Настройки) → Editor (Редактор) → Advanced (Дополнительно) → Vim key bindings.

Расширить возможности

Для расширения возможностей редактора пользователь имеет возможность самостоятельно подключить и настроить как встроенные, так и сторонние плагины.

Разделитель