Код, формулы и диаграммы

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

Код в строке

Заключите короткую команду, имя файла или параметр в обратные кавычки либо выделите текст и нажмите ⌥⌘C:

Restart the router, then run `ping 1.1.1.1` to check.

Блоки кода

Для нескольких строк используйте блок кода. Нажмите ⌃⌘C или введите три обратные кавычки на отдельной строке. Varlig добавит закрывающие кавычки и предложит выбрать язык. Например, python или swift включает соответствующую подсветку синтаксиса.

```python
for item in packing_list:
    print(item)
```

Кнопка Copy Code рядом с блоком копирует его содержимое без обратных кавычек. Строки с кавычками скрыты, пока курсор находится вне блока.

Два языка особенные: calc превращает блок в калькулятор (см. Ваш первый расчет), а mermaid рисует диаграмму, как показано ниже.

Длинные строки

По умолчанию длинные строки кода переносятся. Параметр Settings › Editor › Scroll long code lines instead of wrapping сохраняет каждую строку целиком и включает горизонтальную прокрутку. Символ … показывает продолжение; перемещение курсора раскрывает скрытую часть, а горизонтальный жест над блоком прокручивает его. Текст заметки не меняется: дополнительные символы не вставляются, а копирование и экспорт возвращают ровно то, что вы написали.

Формулы

Записывайте математические выражения в нотации TeX. Для формулы внутри предложения заключите её в одиночные знаки доллара (Format › Math Formula). Для отдельного блока используйте двойные знаки доллара на отдельных строках (Format › Math Block):

The area of a circle is $\pi r^2$.

$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

Когда курсор находится в формуле, видны её исходный текст и предпросмотр, обновляющийся при вводе. Varlig поддерживает распространённые команды TeX. Неизвестная команда выводит ошибку вместо формулы.

Формула оформляет математическое выражение. Чтобы получить числовой результат, используйте блок calc.

Диаграммы Mermaid

Опишите блок-схему, временную шкалу или другую диаграмму текстом, и Varlig нарисует её в заметке. Выберите Format › Mermaid Diagram, чтобы вставить заготовку, или создайте блок mermaid:

```mermaid
flowchart LR
  Idea --> Plan --> Done
```

Первая строка задаёт тип диаграммы. Varlig поддерживает блок-схемы (flowchart или graph), sequenceDiagram, classDiagram, stateDiagram, erDiagram, pie, gantt, journey, timeline, mindmap, gitGraph, quadrantChart, xychart, sankey, kanban и другие. Диаграмма обновляется вслед за изменениями текста.

Диаграмма может содержать до 512 строк исходного текста, 256 блоков и 512 связей.

Метаданные YAML в начале файла

Некоторые инструменты читают метаданные из верхней части файла Markdown. Выберите Format › YAML Front Matter, чтобы добавить блок между двумя строками --- в самом начале заметки:

---
project: Kitchen
status: planning
---

Varlig сохраняет блок метаданных front matter в точности как написано и использует первую строку после него в качестве заголовка заметки.

HTML

Varlig показывает HTML-теги в виде текста, а не превращает их в форматирование. Исключением является <br>, который начинает новую строку.