Заголовки и стили текста

Заголовки придают заметке структуру, а форматирование выделяет важные слова. Всё на этой странице — обычный Markdown: вводите символы вручную или пользуйтесь меню Format и сочетаниями клавиш. Varlig скрывает разметку при письме, сохраняя удобство чтения.

Заголовки

Начните строку с одного–шести символов # и пробела либо поместите курсор в строку и нажмите сочетание от ⌘1 до ⌘6. Повторное нажатие превращает заголовок обратно в обычный текст.

# Holiday plans
## Things to pack
### Documents

Символы # скрыты даже при редактировании строки. Когда курсор находится в заголовке, значок на полях показывает его уровень. Нажмите его, чтобы изменить уровень, свернуть раздел или выбрать Copy Link to here для прямой ссылки на этот заголовок из другой заметки. См. Теги, ссылки и обратные ссылки.

Вы также можете подчеркнуть строку, чтобы сделать ее заголовком: под ней === создает Заголовок 1, а --- создает Заголовок 2.

Сворачивание раздела

Нажмите ⌘', поместив курсор в раздел, чтобы скрыть его содержимое; повторное нажатие раскрывает раздел. Команда Format › Unfold All раскрывает все разделы. Точно так же можно свернуть вложенные пункты списка.

Сворачивание помогает увидеть структуру длинной заметки. Как только вы начнёте вводить текст, все разделы раскроются.

Для быстрой навигации по длинной заметке откройте список заголовков командой View › Toggle Table of Contents (⇧⌘A).

Оглавление внутри заметки

Команда Format › Insert Table of Contents вставляет под текущей строкой список ссылок на заголовки заметки. Вложенность соответствует уровням заголовков. Список ограничен двумя строками комментариев:

<!-- contents -->
- [Before you go](varlig://open-note?id=…&header=Before%20you%20go)
  - [Packing](varlig://open-note?id=…&header=Packing)
<!-- /contents -->

Каждая ссылка совпадает с той, которую копирует Copy Link to here, и ведёт к соответствующему заголовку. Заголовок самой заметки и заголовки внутри кода в список не входят.

Оглавление не обновляется автоматически. Команда Format › Update Table of Contents пересоздаёт его по текущим заголовкам. Если оглавление уже есть, Insert Table of Contents тоже обновит его. Каждое действие можно отменить одним шагом. Другие редакторы Markdown скрывают строки комментариев и показывают список заголовков со ссылками, открывающими заметку в Varlig.

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

Полужирный шрифт, курсив и другие стили

Выделите слова и нажмите сочетание клавиш либо окружите их символами разметки. Если ничего не выделено, сочетание включает стиль для дальнейшего ввода; повторное нажатие выключает его.

The ferry is **not** refundable, so _double-check_ the date.
Bring the ==blue folder== and ~sign~ the forms, but ~~print the maps~~.
Booking reference: `LX-4821`

Также работают *italic* и __bold__. Если курсор внутри оформленного текста, соответствующее сочетание клавиш снимает стиль.

Цвета выделений

Через Format › Highlight Color выберите зелёный, красный, синий, жёлтый, фиолетовый цвет или Default. В Markdown цвет задаётся эмодзи сразу после открывающего ==:

Эмодзи скрыт, пока курсор находится вне выделенного фрагмента. Внутри фрагмента он превращается в элемент выбора цвета.

View › Toggle Highlights (⇧⌘H) перечисляет каждый выделенный отрывок в заметке, в ее цвете, под заголовком, а Copy Highlights копирует их все как список Markdown. См. информацию о заметке.

Цитаты и информационные блоки

Начните строку с > для цитаты (⇧⌘T). Return продолжает цитату, а Return на пустой строке цитаты завершает её.

Информационный блок привлекает внимание к важной детали. Выберите тип в Format › Callout или введите > [!TIP], при желании добавив заголовок:

> [!TIP] Before you leave
> Check the passports are in the front pocket.

> [!WARNING]
> The last ferry leaves at 18:30.

Тип указывается прописными буквами: NOTE, TIP, IMPORTANT, WARNING или CAUTION. Если заголовок не задан, показывается название типа. Поместив курсор в информационный блок, можно изменить тип через Format › Callout.

Разделители

Format › Line Separator (⌥⌘S) рисует линию между темами. Чтобы ввести один, поместите --- на его собственную строку с пустой строкой над ней. Без пустой строки --- превращает строку выше в заголовок.

Сноски

Команда Format › Footnotes › Footnote (⇧⌘E) вставляет в позицию курсора номер сноски, например [^1], и добавляет в конец заметки строку [^1]: footnote text для её текста. Ссылка отображается небольшим надстрочным номером, по которому можно перейти. Команда Renumber Footnotes упорядочивает номера после перестановок.

The castle opens at nine.[^1]

[^1]: Closed on Mondays in winter.

Подсказки произношения

Надстрочная подсказка показывает произношение слова: например, фуригану над кандзи или транслитерацию имени. Запишите основной текст в квадратных скобках, а чтение сразу за ним — в фигурных:

子どもの頃に[漢字]{かんじ}を覚えました。

Выделите слова и выберите Format › Add Reading…. В диалоге появится заголовок Reading for "漢字" и поле Reading. Кнопка Add вставляет разметку одним действием, которое можно отменить.

Поместите курсор в подсказку чтения и откройте контекстное меню с Edit Reading… и Remove Reading. В диалоге будут кнопки Save и Remove Reading. Удаление подсказки сохраняет основной текст. В заметке только для чтения вместо них доступна команда Show Reading….

В редакторе подсказка отображается мелким шрифтом над основным текстом. Скобки скрыты, пока курсор или выделение не попадут в аннотацию, как и в другой разметке Markdown. Заголовки заметок, выдержки в списках и обратных ссылках, а также подсчёт слов учитывают только основной текст.

Символы ]{ должны идти подряд, без пробела между квадратной и фигурной скобкой. Поэтому [漢字] {かんじ} остаётся обычным текстом. Основной текст не может содержать [ или ], а подсказка — { или }. В обоих запрещены табуляции и переводы строки; длина каждого — не более 120 символов. Для одного фрагмента допускается одна подсказка без вложенности. Внутри кода, математических выражений, другой подсказки или текста с комментарием добавить её нельзя.

При экспорте подсказка отображается с учётом возможностей формата:

Скобки <rp> в HTML и EPUB позволяют приложениям без поддержки ruby показывать подсказку в скобках, а не терять её.

Даты, эмодзи и специальные символы

• Сегодняшняя дата: Format › Current Date вставляет дату и время (⇧⌘7), дату (⇧⌘8), короткую дату (⇧⌘9) или время (⇧⌘0) в формате вашего Mac. В том же меню есть версии ISO 8601, такие как 2026-09-16, для заметок, которые сортируются по дате.
• Эмодзи: введите двоеточие и начало слова, например :ten, затем выберите подсказку. Varlig вставит сам эмодзи.
• Сам по себе символ: поместите обратную косую черту перед символом, чтобы остановить его форматирование, чтобы \#1 оставался текстом, а не тегом.

Перемещение строк и отступы

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

Предпочитаете кнопки?

View › Toggle Style Bar (⇧⌘Y) показывает кнопки форматирования над заметкой. А когда заметка закончена, Note › Make Read-Only защищает ее от случайных изменений.