Пропустить к содержанию
Руководство Varlig
Главная страница Varlig

Редактирование Markdown-файлов на месте

Файлы Markdown могут находиться вне библиотеки: README в Git-репозитории, файл в iCloud Drive, заметки от коллеги. Varlig позволяет редактировать их прямо на месте, не копируя в библиотеку.

Открыть файл

Выберите File › Open Markdown File… (⌥⌘O), откройте файл в Finder через Открыть в программе ▸ Varlig или выполните open -a Varlig notes.md в Терминале. Varlig открывает .md, .markdown, .txt и похожие текстовые файлы размером до 32 МБ.

Окно файла использует тот же редактор, что и заметки. В заголовке видны метка FILE, имя файла, папка и состояние сохранения. Кнопка папки показывает файл в Finder.

Открыть папку

Выберите File › Open Folder… (⌃⌘O), перетащите папку на значок Varlig в Dock или выполните open -a Varlig ~/Projects/handbook в Терминале. На боковой панели окна будут перечислены Markdown и текстовые файлы, сгруппированные по подпапкам. Выбранный файл открывается в обычном редакторе. При первом открытии выбирается README, если он есть; затем Varlig возвращается к последнему прочитанному файлу.

Список автоматически отражает изменения в папке: добавление, удаление и переименование файлов другим приложением или командой git checkout. Скрытые папки, например .git, а также node_modules не показываются. Поле Filter files фильтрует список по имени или пути, а + создаёт пустой Untitled.md рядом с текущим файлом. При переходе к другому файлу предыдущий сохраняется. Относительная ссылка на файл в той же папке открывает его в этом же окне.

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

Сохранение

Изменения сохраняются автоматически примерно через секунду после окончания ввода. File › Save (⌘S) сохраняет их немедленно. В заголовке отображается Saved, Edited или Save failed с указанием причины.

Varlig сохраняет исходный формат файла: окончания строк, метку порядка байтов и завершающий перевод строки, если он был. Запись атомарна и сохраняет права доступа, поэтому Git показывает только реальные изменения текста.

File › Save As… записывает копию в другом месте и продолжает редактировать эту копию.

Относительные ссылки отсчитываются от папки файла: ![](diagrams/flow.png) и [the plan](plan.md) открывают ожидаемые файлы. Разрешён переход до трёх уровней вверх. Вставленное или перетащенное изображение сохраняется рядом с файлом в папке с соответствующим именем, например notes.assets/.

Теги и [[note links]] - это обычный текст в окне файла: они принадлежат вашей библиотеке, и файлу на диске их негде хранить.

Когда файл меняется на диске

Если при наличии несохранённых правок файл изменяет что-то ещё — git pull, программа синхронизации или другой редактор, — Varlig сохраняет обе версии и сообщает о конфликте:

  • Compare… показывает версии рядом, выделяя содержимое, которое есть только на диске или только в окне редактора.
  • Keep Mine сохраняет вашу версию, а версию с диска оставляет рядом в отдельной копии с датой в имени.
  • Use Disk Version открывает версию с диска, а вашу сохраняет рядом в отдельной копии с датой в имени.

Ничего не перезаписывается ни в каком случае, и копии имеют названия, чтобы вы могли их отличить, например notes (disk version 2026-09-22 1415).md.

Если файл удалён или перемещён во время редактирования, Varlig сообщает об этом и предлагает Save As…, чтобы вы могли сохранить текст в другом месте.

Форматы результатов сохраняются в файле

Формат результата строки — количество десятичных знаков, разделители, вид записи — и параметры Subtotal или Time Point хранятся в расширенном атрибуте файла, а не в тексте Markdown. Текст остаётся вашим, а при следующем открытии файла, отдельно или в окне папки, строки выглядят так же, как раньше. Настройки сохраняются при редактировании, вставке и перемещении строк. Если текст строки удалён, её настройки удаляются вместе с ним, а не переходят к другой строке.

Некоторые инструменты не сохраняют расширенные атрибуты: Git, большинство ZIP-архиваторов, отдельные службы синхронизации и диски в форматах Windows. В таком случае возвращается стандартное оформление результатов, но текст не меняется. Чтобы Varlig вообще не записывал эти метаданные, отключите Remember answer formats in Markdown files в Settings › Editor. По умолчанию этот параметр включён.

Особенности окна файла

  • Нет истории версий, нет пароля заметок и нет резервных копий: файл на диске является единственной копией.
  • Расчетные блоки работают как обычно. Формат ответа или настройка строки, которую вы выбираете для одной строки, сохраняется с файлом, как указано выше, а не в его тексте.
  • Ссылки varlig:// открывают заметки, но никогда не запускают автоматизацию из файла.