1. Установка

  1. Установите Obsidian с сайта obsidian.md
  2. Включите плагины сообщества в разделе «Настройки», «Плагины сообщества»
  3. Установите Better Paste: нажмите «Обзор», найдите «Better Paste», а затем нажмите «Установить»

2. Для чего это нужно

Десять примеров. Некоторые запускаются при каждом вставке, другие — это команды, которые нужно запускать по мере необходимости.

2.1 Пользовательские фрагменты кода

Создайте собственные правила поиска и замены с использованием регулярных выражений — они будут запускаться при каждой вставке текста. Это правило удаляет маркери цитирования из Perplexity:

The fix shipped last week[1][2] and rollout begins today[3].

становится

The fix shipped last week and rollout begins today.

В состав плагина входят два готовых фрагмента кода, которые можно редактировать или отключить: «Удалить жирный шрифт из заголовков » и «Сворачивать пустые строки». На вики-странице можно найти и другие фрагменты для импорта, например, для преобразования математических формул из ChatGPT. О том, как пишется правило, рассказывается в разделе 3.5.

2.2 Изображения из Safari

Если воспользоваться функцией «Копировать изображение» в Safari, в буфере обмена появятся две версии: само изображение и его веб-адрес. Obsidian вставляет адрес, но вы скопировали изображение и ожидаете увидеть именно его. Функция «Better Paste» вставляет изображение, сохраненное в вашем хранилище:

![](https://images.example.com/2026/05/skyline-8f21a.jpg?auto=format&w=2400)

становится

![[skyline-8f21a.jpg]]

2.3 Параметры отслеживания

Ссылки, которые вы копируете из информационных рассылок и приложений социальных сетей, содержат много ненужных отслеживающих элементов. Better Paste удаляет их:

https://www.theverge.com/2026/1/9/story?utm_source=newsletter&utm_medium=email&fbclid=IwAR2x9

становится

https://www.theverge.com/2026/1/9/story

2.4 Заголовки ссылок

Вставьте простой URL-адрес, и он превратится в ссылку в формате Markdown с реальным названием страницы:

https://obsidian.md

становится

[Obsidian - Sharpen your thinking](https://obsidian.md)

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

Список ссылок тоже подойдет. Вставьте несколько URL-адресов, каждый в отдельной строке, и у каждой ссылки появится свой заголовок.

Загруженные заголовки часто заканчиваются названием сайта, например · GitHub или - YouTube. Включенный фрагмент кода со ссылкой «Удалить названия сайтов из заголовков» удаляет эти части, и вы можете добавить свои собственные правила — см. раздел 3.5.

Reddit, YouTube, TikTok и Loom блокируют обычный просмотр страниц, поэтому их заголовки берутся из собственных сервисов встраивания каждого сайта, а для Stack Overflow и других сайтов Stack Exchange — через API Stack Exchange. В ссылках на обмен файлами Dropbox в качестве заголовка используется имя файла или папки, а в URL-адресах Obsidian — название заметки.

2.5 Вложенные списки

Скопируйте вложенный список, вставьте его глубоко внутрь другого списка — и старый отступ сохранится, что приведёт к нарушению структуры дерева. Функция «Улучшенная вставка» переформатирует отступы всего списка так, чтобы он соответствовал уровню вставляемого элемента. Вот так:

- [ ] Trip planning
    - [ ] Book hotel
    - [ ] Pack
        - [ ] Chargers

вставлен в пустой элемент в

- Projects
    - Summer
        -

становится

- Projects
    - Summer
        - [ ] Trip planning
            - [ ] Book hotel
            - [ ] Pack
                - [ ] Chargers

Функция работает с маркированными и нумерованными списками, а также с флажками, независимо от уровня вложенности элемента назначения и от того, используются ли в исходном тексте табуляции или пробелы. Текст, который не является чисто списком или не вставляется в элемент списка, отображается точно так же, как и раньше. Текст с форматированием, взятый с веб-страниц, проходит преобразование в HTML с помощью Obsidian.

2.6 Цитаты в виде блоков

При вставке нескольких абзацев в блок цитаты цитируется только первая строка — эта проблема существует в Obsidian уже много лет. Лучше было бы, чтобы каждая вставленная строка попадала в цитату, чтобы весь текст оставался внутри цитаты. Вот так:

We started in a garage.

Two years later we were forty people.

вставлено в выноску

> [!quote] From the interview
>

становится

> [!quote] From the interview
> We started in a garage.
>
> Two years later we were forty people.

Это работает как с обычными блочными цитатами, так и с выносками.

2.7 Вывод данных на терминал

Терминалы разбивают длинные строки по краю окна. При каждой вставке коды Escape удаляются, а если выделить вставленный вывод и запустить команду «Очистить вывод терминала», строки снова соединяются:

npm warn deprecated inflight@1.0.6: This module is not supported and leaks memory. Do
  not use it. Check out lru-cache instead.

становится

npm warn deprecated inflight@1.0.6: This module is not supported and leaks memory. Do not use it. Check out lru-cache instead.

2.8 Текст из PDF-файлов

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

The findings suggest that long-term expo-
sure has a measurable effect on the out-
come in both groups.

становится

The findings suggest that long-term exposure has a measurable effect on the outcome in both groups.

Лигатуры, такие как «fi», также превращаются в настоящие буквы, поэтому поиск снова находит эти слова.

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

2.9 Очистка текста, сгенерированного искусственным интеллектом

Текст чат-бота содержит фигурные кавычки, длинные тире и невидимые символы. Невидимые символы удаляются при каждой вставке, а при включенной настройке «Кавычки и тире» остальной текст также преобразуется в обычный текст:

“It works,” she said — finally.

становится

"It works," she said - finally.

2.10 Запятые и кавычки

Предпочитаете, чтобы запятые стояли за кавычками? Выделите текст и запустите функцию «Переместить запятые за кавычки»:

She called it "finished," then left.

становится

She called it "finished", then left.

При перемещении запятых внутрь кавычек порядок меняется на обратный.


3. Настройки

Вот те настройки, которые вам действительно понадобятся.

3.1 Поведение

  • Очистка всех вставленных фрагментов: главный переключатель. Выключите его, чтобы использовать только команды или очистить только ноты, помеченные как « bp: true » (см. раздел 4).
  • Свойство «Note» (по умолчанию — « bp »): переключатель для отдельных нот из раздела 4. Переименуйте его, если он конфликтует с каким-либо элементом в вашем хранилище, или оставьте поле пустым, чтобы отключить его.

3.2 Приложения

  • Веб-изображения: что происходит, когда вставленный фрагмент содержит ссылку на изображение в Интернете — в виде простого URL-адреса или в составе скопированного веб-контента. При выборе варианта «Ссылка с предварительным просмотром»(по умолчанию) вставляется встроенный элемент, отображающий изображение прямо из Интернета. Вариант «Загрузить с предварительным просмотром» сохраняет копию в вашем хранилище (в папке, указанной в настройках вложений) с именем, соответствующим исходному файлу, так что больше не будет ссылок типа image.png. Вариант «Ничего не делать» оставляет обработку вставленных изображений на усмотрение Obsidian. Изображение, скопированное в браузере, содержит в буфере обмена фактическое изображение, поэтому оно сохраняется в вашем хранилище как при выборе «Ссылка с предварительным просмотром», так и при выборе «Скачать с предварительным просмотром» (см. пример 2.2).
  • Вставленные файлы: что происходит при вставке файлов с вашего устройства, таких как PDF-файлы и скриншоты. Настройка «Ничего не делать»(по умолчанию) оставляет вставку на усмотрение Obsidian, включая предварительный просмотр. Настройка «Ссылка без предварительного просмотра» вставляет вместо этого обычную ссылку, так что ![[Document.pdf]] превращается в [[Document.pdf]]. Файлы по-прежнему сохраняются в соответствии с вашими настройками вложений в Obsidian.
  • Имена файлов: добавьте свой собственный формат, например {{name}}-YYYY-MM-DD. Вы также можете использовать {{noteName}} для имени заметки, {{property:xyz}} для любого свойства frontmatter и {{counter}} или {{counter:2}} для номера, который увеличивается. У скриншота нет имени источника, поэтому он получает имя Pasted image плюс временную метку — то же имя, которое ему присваивает Obsidian. Если в заметке указано attachName: demo и используется формат {{property:attachName}}-{{counter}}, вставленные скриншоты получают имена demo-1.png, demo-2.png, demo-3.png. Этот формат применяется ко всем изображениям, сохраняемым Better Paste, включая скриншоты.
  • Размер и стиль: присвойте каждому сохраненному изображению ширину, класс или и то, и другое, чтобы при вставке оно отображалось как ![[photo.jpg#invert|400]]. Определите собственные списки, разделенные запятыми, например 200, 400, 600 и invert, invertW, а затем примените одно значение везде или выберите «Спрашивать при каждой вставке», чтобы каждый раз выбирать параметры в небольшом диалоговом окне (нажатие Enter подтверждает выбор, а последний выбранный вариант будет предварительно выбран). Классы, такие как #invert, определяются темами и фрагментами CSS, например, для инвертирования изображения в тёмном режиме. Свойство «Ширина изображения» (по умолчанию image-width) задаёт ширину для каждой заметки, см. раздел 4.

Альтернативный текст сохраняется, и в случае сбоя при загрузке исходная ссылка остается в заметке. Изображения размером более 50 МБ или загрузка которых занимает более 30 секунд сохраняются в виде ссылок. Заметка с собственным свойством image-width (см. раздел 4) переопределяет настройку размера.

3.3 Ссылки

  • Получать названия для вставленных ссылок: по умолчанию включено, см. пример 2.4 выше.
  • Очистка вставленных ссылок: удаляет повсеместно встречающиеся трекеры, а также известные ненужные элементы с таких сайтов, как YouTube, Google и Amazon.
  • Удаление ссылок: укажите названия параметров, которые также необходимо удалить везде или на определённых сайтах. С помощью онлайн-тестера можно посмотреть результат ещё до вставки:
https://www.youtube.com/watch?v=dQw4w9WgXcQ&list=PLxAbC123&si=8f2a1c&utm_source=share&t=42
https://www.amazon.com/dp/B0CHX1W1XY/ref=sr_1_3?crid=2ABCDE&keywords=usb+hub&qid=1735689600&sr=8-3
https://www.google.co.uk/search?q=obsidian+plugins&client=safari&sca_esv=9f1&sourceid=chrome

становится

https://www.youtube.com/watch?v=dQw4w9WgXcQ&list=PLxAbC123&t=42
https://www.amazon.com/dp/B0CHX1W1XY/ref=sr_1_3?keywords=usb+hub
https://www.google.co.uk/search?q=obsidian+plugins

Удаление выглядит следующим образом:

fbclid
mine.example | source, ref

fbclid удаляет этот параметр на всех сайтах. Файл mine.example | source, ref удаляет source и ref на сайте mine.example и его субдоменах, при этом все остальные параметры остаются. А файл google.* одинаково подходит как для google.com, так и для google.se. Вы можете увидеть все встроенные правила удаления; обновления этого файла поступают вместе с выпусками плагина. Чтобы предложить свои правила удаления, откройте файл betterpaste.md с уже заполненным списком. Просмотрите его там, а затем откройте черновик в своем почтовом приложении. Криптографически подписанные ссылки остаются без изменений. Общие файлы и подарочные статьи сохраняют свои параметры доступа.

Чтобы отключить встроенные меры по удалению для одного сайта, добавьте в файл конфигурации строку « ! »:

!youtube.com

3.4 Обработка текста

  • Удаление лишних пробелов вокруг вставленного текста: удаляются пустые строки и лишние пробелы вокруг вставленного текста. Пустые строки в середине остаются.
  • Невидимые символы: удаляет пробелы нулевой ширины и преобразует неразрывные пробелы в обычные. Эмодзи, соединительные символы в персидском и арабском языках, а также пробелы в системах CJK остаются без изменений.
  • Цитаты: преобразует фигурные кавычки и апострофы в прямые, так что “don’t” превращается в "don't". По умолчанию эта функция отключена, поэтому формат текста сохраняется до тех пор, пока вы не включите её.
  • Тире: преобразует длинные и средние тире в обычные дефисы. Также по умолчанию отключено. Кавычки и тире внутри кода, ссылок и названий примечаний остаются без изменений.

3.5 Индивидуальная обработка

  • Фрагменты текста: ваши собственные правила на основе регулярных выражений, которые применяются ко всему вставленному тексту после встроенных правил. У каждого фрагмента есть свой переключатель, и они запускаются в порядке, указанном в списке, поэтому перетаскивайте их, чтобы изменить порядок. Функции «Удалить жирный шрифт из заголовков» и «Свернуть пустые строки» входят в состав плагина.
  • Фрагменты ссылок: аналогичные правила, которые применяются к каждой вставленной ссылке после формирования её заголовка. Правило обрабатывает готовую ссылку в формате Markdown, при этом адрес остаётся неизменным. Функция «Удалять названия сайтов из заголовков» входит в состав плагина и удаляет окончания типа · GitHub и - YouTube.
  • Каждая строка содержит одно правило замены с использованием регулярного выражения JavaScript в формате s/find/replace/flags. Строки, начинающиеся со #, являются комментариями:
# Remove Perplexity citations
s/\[\d+\]//g
  • Попробуйте: введите пример текста и понаблюдайте, как все включенные фрагменты кода выполняются на нём в режиме реального времени. Для фрагментов с ссылками предусмотрен собственный тестер, который принимает ссылку в формате Markdown. В редакторе фрагментов кода также доступен предварительный просмотр создаваемого фрагмента.
  • Импорт и экспорт фрагментов: перемещайте фрагменты между хранилищами с помощью буфера обмена. Готовые фрагменты можно найти в вики; скопируйте нужный фрагмент оттуда и вставьте его сюда.
  • Открытая платформа для работы с регулярными выражениями: открывает среду Regex101, в которой наглядно показано, как действуют правила, для создания и тестирования шаблонов поиска.

3.6 Структура

  • Сохранять вложенность списков при вставке: включено по умолчанию, см. пример 2.5 выше.
  • Продолжение цитат при вставке: также включено по умолчанию, см. пример 2.6 выше.

Правила структуры выполняются после правил текста, поскольку они анализируют примечание вокруг курсора и изменяют форму очищенного текста, чтобы он вписался в него.


4. Регулировка по каждой ноте

Добавьте строку « bp: false » в начальную часть заметки, и Better Paste не будет ее редактировать. Идеально подходит для журналов и стенограмм:

---
bp: false
---

Это работает и в обратном направлении: команда « bp: true » очищает заметку даже при отключенной опции «Clean up every paste ».

Очистить каждую вставку Отсутствует свойство « bp » bp: true bp: false
Включено очищенных очищено оставлен в покое
Выключено оставлен в покое очищено оставлен в покое

А файл « image-width » задаёт ширину изображений, вставленных в эту заметку:

---
image-width: 400
---

Изображения выводятся в формате ![[picture.png|400]] — собственном синтаксисе Obsidian для указания размера. Также работает формат 400x300.


5 команд

Девять команд, для которых можно настроить собственные горячие клавиши (в разделе «Настройки», «Горячие клавиши»). Идентификаторы предназначены для схем URI и плагинов, таких как Commander, и имеют префикс better-paste:.

  • Вставить (paste): вставить с учетом правил, даже в заметку, для которой отключена эта функция.
  • Вставить без обработки (paste-raw): вставить именно то, что находится в буфере обмена.
  • Очистить выделение (selection-clean): применить правила к выделенному тексту.
  • Очистить вывод терминала (selection-clean-terminal): соединить разбитые на строки фрагменты, удалить начальный отступ и преобразовать маркированные списки • в списки Markdown в выделенном фрагменте. По запросу, поскольку только вы знаете, что текст был получен из терминала.
  • Очистка текста в PDF (selection-clean-pdf): объединение коротких строк, образованных в результате верстки PDF, исправление слов, разбитых дефисами, и разбор лигатур в выделенном фрагменте. В диалоговом окне отображается предварительный просмотр результата и доступны настройки нумерации страниц и абзацев.
  • Запустить фрагмент кода (selection-run-snippet): выбрать фрагмент и применить его к выделенному тексту, даже если он отключен для вставки.
  • «Переместить запятые внутрь кавычек» (selection-commas-inside) и «Переместить запятые за кавычки» (selection-commas-outside): стиль расположения запятых рядом с закрывающей кавычкой, примененный к выделенному тексту.
  • Включить/выключить автоматическую очистку (toggle-cleanup): переключите главный выключатель.

6. Полезно знать

  • Вставленный текст внутри блоков кода, встроенного кода или в предваряющей информации остаётся без изменений, а код в ограждающих символах внутри вставки сохраняется в неизменном виде. Есть одно исключение: если для веб-изображений установлен параметр «Скачать с предварительным просмотром», вставка адреса изображения в пустое поле в режиме исходного кода приводит к сохранению изображения в вашем хранилище с атрибутом "[[skyline-8f21a.jpg]]". Obsidian Bases может отображать его в качестве обложки, а локальная копия работает в автономном режиме.
  • Скриншоты сохраняются приложением Better Paste под теми же именами, которые присваивает им Obsidian, если вы не задали собственный формат имен файлов.
  • Сначала Obsidian преобразует форматированный контент (HTML) в Markdown; затем Better Paste очищает ссылки и применяет настройки веб-изображений к картинкам в полученном результате.

7 языков

Better Paste поддерживает 21 язык: арабский, китайский (упрощённый), китайский (традиционный), голландский, английский, французский, немецкий, индонезийский, итальянский, японский, корейский, персидский, польский, португальский, португальский (Бразилия), русский, испанский, тайский, турецкий, украинский и вьетнамский. Язык приложения зависит от языка, выбранного в Obsidian (изменение вступает в силу после перезапуска).


8. Конфиденциальность

Better Paste работает локально и отправляет сетевые запросы ровно в трёх случаях:

  • загрузка изображения, которое вы вставили
  • получение заголовка вставленной ссылки (чтобы отключить эту функцию, выключите параметр «Получать заголовки для вставленных ссылок »)
  • загрузка графических элементов для диалоговых окон «Добро пожаловать» и «Что нового» с GitHub

Никакой телеметрии, никакой аналитики, и никакие данные никогда не загружаются. Настройки хранятся на сайте .obsidian/plugins/better-paste/data.json и остаются в вашем хранилище.

Каждый релиз проходит проверку с помощью TypeScript, ESLint (с использованием официального плагина Obsidian для ESLint), Stylelint, Prettier, Vitest и проверки на наличие мертвого кода. При появлении предупреждений сборка завершается с ошибкой.


9 О нас

Меня зовут Йохан Саннеблад. У меня есть докторская степень в области разработки программного обеспечения, и я занимался разработкой инновационных решений для таких компаний, как Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group и Yamaha. Кроме того, я разрабатываю Notebook Navigator — самый популярный плагин-файловый менеджер для Obsidian.

Не стесняйтесь добавляться ко мне в LinkedIn!


10 Вопросы или проблемы?

Создайте заявку в репозитории GitHub. В случае ошибок, связанных с вставкой, наиболее полезной информацией будет содержимое вашего буфера обмена: откройте страницу https://dynalist.io/clipboard в приложении, из которого вы скопировали текст, вставьте его туда и приложите вывод, который там отобразится.

Пулл-реквесты не принимаются; вместо этого предлагайте свои идеи в виде запросов на добавление новых функций. Подробности см. в файле CONTRIBUTING.md.


11. Лицензия

Общая общественная лицензия GNU версии 3.0. См. файл LICENSE.