Текст и оформление

Кликните и пишите#

Страницы открываются в режиме «Визуальный» и сразу доступны для правки — без шагов «Править» и «Опубликовать». Курсор и выделение ничего не меняют; меняет только правка, и Kirbon сохраняет ее примерно через секунду после того, как вы перестали печатать.

Все работает как в любом текстовом редакторе на Mac: проверка правописания, автозамены, диктовка, методы ввода, службы и отмена для каждой страницы.

Стили текста#

Внутри строки: жирный ⌘B, курсив ⌘I, зачеркнутый ⇧⌘X и код — Формат ▸ Код или текст в обратных кавычках. Элементы форматирования на панели инструментов показывают, что включено у курсора.

Если хочется спокойной панели, скройте элементы форматирования: Вид ▸ Скрыть элементы форматирования. Тогда при выделении текста над ним появляется маленькая панель.

Меню «/»#

Наберите / в начале строки (или после пробела) — откроется меню вставки. Продолжайте печатать, чтобы отфильтровать, выбирайте стрелками, вставляйте клавишей Return.

В меню есть текст и заголовки 1–3, три вида списков, таблица, блок кода, цитата, разделитель, изображение, файл и пять выносок. Те же блоки есть в Вставить ▾ на панели инструментов и в меню «Вставить» и «Формат».

Списки и задачи#

• Наберите - , * , 1. или [ ] в начале абзаца, чтобы начать маркированный, нумерованный список или список задач.
• Return добавляет пункт; Return на пустом пункте завершает список.
• ⇥ сдвигает пункт под предыдущий, ⇧⇥ — обратно.
• Кликните по флажку или нажмите ⌘↩ (Отметить задачу), чтобы отметить задачу.
• Нумерованные списки сами перенумеровываются, когда пункты добавляются, удаляются или переезжают.
• Формат ▸ Маркированный список, Нумерованный список и Список задач превращают выделенные абзацы в список, меняют вид списка или возвращают выделенные пункты в абзацы.
• ⌫ в начале пункта выводит вложенный пункт на уровень выше, а пункт верхнего уровня превращает в абзац.

Блоки кода#

Блоки кода правятся прямо на странице. Текст пишется как есть — без умных кавычек, автоформата и пометок правописания. ⇥ вставляет табуляцию. Наведите на блок, чтобы выбрать язык из списка, скопировать код одним кликом или включить номера строк (это настройка вида, в файл она не пишется).

Блоки и ручки#

Наведите на блок — на поле появятся два элемента: «+» вставляет новый блок ниже, а за ручку блок можно перетащить в другое место страницы. Клик по ручке открывает меню: Переместить вверх, Переместить вниз, Скопировать и Удалить.

С клавиатуры: Переместить блок вверх и вниз (⌃⌘↑ ⌃⌘↓) двигают блок у курсора — пункт списка едет вместе с вложенными. Esc выделяет блок вокруг курсора; затем ⌫ удаляет его, а ⌘C копирует.

Заголовки и ссылки на них#

Наведите на заголовок — появится якорь: клик по нему копирует ссылку на этот заголовок, ее можно вставить на другую страницу. Заголовки 5 и 6 пишутся в режиме «Markdown»; «Визуальный» предлагает заголовки 1–4.

Сноски и другое содержимое внутри строки#

Ссылки на сноски видны как надстрочные номера, а сами сноски — в конце страницы. Сноски, HTML внутри строки, изображения внутри строки, жесткие переносы и экранированные символы ведут себя при наборе как один символ: их можно удалить или передвинуть целиком, а записываются они в точности как были.

Отмена#

Отмена работает для каждой страницы отдельно и привычными шагами: по шагу на паузу в наборе, по шагу на команду форматирования. Она общая для режимов «Визуальный» и «Markdown» — можно переключиться и все равно отменить.

Что Kirbon оставляет как есть#

Некоторый Markdown нельзя править визуально без риска: HTML-блоки, front matter, HTML-комментарии и незнакомые расширения вроде диаграмм Mermaid. Kirbon показывает их подписанными блоками только для чтения — например, «Блок HTML · 6 строк» — с кнопкой Изменить в Markdown. Они всегда записываются байт в байт. Подробнее — в разделе Совместимость с Markdown.