Почему вставка изображения проходит через карточку подтверждения

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

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

Файл создаётся только после нажатия кнопки сохранения

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

assets/plain-20260907-181756.png

В имя файла входят название документа и время вставки. Так легко понять, из какого документа взято изображение, а если вставить несколько изображений, они не перезапишут друг друга. Папка по умолчанию — assets, но её можно изменить в настройках.

После нажатия кнопки сохранения PNG-файл атомарно записывается в указанное место, а в позицию каретки вставляется ссылка. При отмене файл также не создаётся.

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

Когда файл изображения перетаскивают в окно, он не копируется. Если файл находится внутри папки документа, вставляется относительный путь, а если за её пределами — абсолютный. Редактор не меняет по своему усмотрению местоположение файла, уже выбранное пользователем.

Изменение размера записывается в документ

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

После отпускания маркера размер записывается в конце alt-текста.

• Если изменилась только ширина: |300
• Если ширина и высота изменялись по отдельности: |300x200

Используется тот же способ, что и в Obsidian, поэтому там изображение отображается в том же размере. Изменение размера сохраняется в истории редактирования, и его можно отменить одним действием.

Этот синтаксис не входит в стандарт CommonMark. В программах просмотра, которые его не поддерживают, |300 может отображаться как часть alt-текста. И всё же мы решили не прятать информацию о размере в отдельном файле. Потому что считаем, что состояние документа должно храниться в одном файле .md.

Неиспользуемые изображения не удаляются сразу

Если удалить или отменить ссылку на вставленное изображение, может остаться только PNG-файл. В этом случае mote один раз спрашивает, нужно ли переместить файл в корзину. Он не удаляет файлы без разрешения и не спрашивает повторно о том же файле.

Это касается только файлов, созданных mote в текущем сеансе редактирования. Изображения, уже находившиеся в папке, и файлы, добавленные пользователем вручную, не затрагиваются. mote также не просматривает папку в поисках неиспользуемых изображений.

Мы наводим порядок только среди созданных нами файлов и только с согласия пользователя.

Исходные файлы не изменяются

mote не загружает изображения во внешние сервисы. Он также не предоставляет функций обрезки, поворота или коррекции.

Только при отрисовке на экране изображение декодируется в уменьшенном виде так, чтобы ни одна из сторон не превышала 2048 px. Декодированные пиксели хранятся в объёме не более 64 MB, после чего самые старые удаляются. Это сделано для того, чтобы в документах с большим количеством фотографий потребление памяти не росло бесконечно.

Даже в ходе этого процесса исходный файл не изменяется.

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

Изображение — это файл, находящийся за пределами документа. Решать, создавать ли его, оставлять или удалять, должен пользователь, а не редактор.