1 安装

  1. 从obsidian.md安装 Obsidian
  2. 在“设置”下的“社区插件”中启用社区插件
  3. 安装 Better Paste：点击“浏览”，搜索“Better Paste”，然后点击“安装”

2 功能介绍

六个示例。每条规则都有自己的开关，因此请关闭您不需要的规则。

2.1 来自 Safari 的图片

在 Safari 中复制一张图片，将其粘贴到 Obsidian 中，结果显示的却是一个网页链接，而不是图片。真烦人！Better Paste 可以将实际图片保存到你的保险库中：

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

变成

![[skyline-8f21a.jpg]]

2.2 跟踪参数

从新闻通讯和社交应用中复制的链接往往会附带大量追踪垃圾信息。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.3 链接标题

粘贴一个纯URL，它就会变成一个带有真实页面标题的Markdown链接：

https://obsidian.md

变成

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

URL 会立即被粘贴，并在标题出现时自动更新，因此不会造成任何阻塞。

2.4 终端输出

终端会在窗口边缘将长行拆分成多行。Better Paste 会去除转义码，并将这些行重新拼接起来：

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.5 人工智能文本

聊天机器人生成的文本中包含花括号引号、长破折号和不可见字符。Better Paste 会将其转换为纯文本：

“It works,” she said — finally.

变成

"It works," she said - finally.

同时还会删除这些不可见字符（零宽度空格等）。

2.6 逗号和引号

更喜欢将逗号放在引号外面吗？Better Paste 可以帮你调整位置：

She called it "finished," then left.

变成

She called it "finished", then left.

要么在里面，要么别管它们。默认情况下保持不变。


3 设置

共有十八种设置。以下是您真正会用到的那些。

3.1 行为

  • 清理所有粘贴内容：主开关。将其关闭可仅使用命令，或仅清理标记为bp: true 的笔记（参见第4节）。
  • 当补丁发生变更时显示一条通知：简要概述修复内容，仅限一行。

3.2 图片

  • 将粘贴的图片保存到图库：支持 Safari 的“复制图片”功能、复制网页内容中的图片，以及粘贴的图片 URL。图片将保存至您的附件设置指定的位置，并以源文件命名，因此不再出现image.png 这样的文件名。
  • 文件名：请按自己的格式命名，例如{{name}}-YYYY-MM-DD 。

替代文本在下载后仍会保留，如果下载失败，原始链接仍会保留在你的笔记中。大于 50 MB 或下载时间超过 30 秒的图片将以链接形式保留。

3.3 链接

  • 获取粘贴链接的标题：默认开启，参见上文示例 2.3。
  • 清理粘贴的链接以及应删除哪些参数：删除所有参数，仅保留网站规则允许保留的参数；或者谨慎操作，仅删除已知的追踪器。
  • 网站规则：内置了33个网站，并配有实时测试工具。这就是为什么YouTube链接在去除跟踪代码后仍能保留视频ID的原因：
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
https://www.google.co.uk/search?q=obsidian+plugins

站点规则如下所示：

youtube.com | v, t, list, index, start     keep only these parameters
gitlab.com                                 keep every parameter
google.* | q, tbm, hl                      any top-level domain
mine.example | id                          your own rule

子域名会自动被涵盖，google.* 既匹配 google.com 也匹配 google.se，且仅保存您自己的编辑内容，因此未来版本中的新规则仍会生效。

3.4 终端文本

  • 清理终端输出：参见上文示例 2.4。
  • 终端文本处理：选择何时将行重新合并（默认仅合并缩进行，这也是最稳妥的选择），将• 中的项目符号转换为Markdown列表，并可在实时测试器中尝试所有功能。

3.5 文本处理

  • 修剪周围的空白：删除粘贴内容周围的空行和多余空格。中间的空行保留不变。
  • 逗号和引号：置于内部、置于外部，或保持不变（默认）。
  • AI清理：隐形字符：移除零宽度空格，并将不可分空格转换为普通空格。表情符号、波斯语和阿拉伯语连接符以及中日韩空格保持不变。
  • AI 清理：连字符和引号：将长连字符转换为- ，将花括号引号转换为直引号。

3.6 前言

  • 请注意“笔记”属性（默认值：bp ）和“图片宽度”属性（默认值：bp-image-width ）：这是第4节中提到的两个针对每条笔记的属性。如果它们与您“保险库”中的其他内容名称冲突，请重命名它们；或者将其中一个留空以将其禁用。

4 逐音符控制

在笔记的前置信息中添加bp: false ，Better Paste 就会忽略该笔记。非常适合日志和记录：

---
bp: false
---

反之亦然：即使“每次粘贴时清理”选项处于关闭状态，bp: true 仍会清理该音符。

清理所有粘贴内容 不存在bp 属性 bp: true bp: false
已 已清理 已清理 未处理
关闭 保持原状 已清理 被单独留下

此外，bp-image-width 用于设置粘贴到该笔记中的图片宽度：

---
bp-image-width: 400
---

图像以![[picture.png|400]] 格式输出，这是Obsidian特有的尺寸语法。400x300 同样有效。


5 条命令

四个命令，可自定义快捷键（设置，快捷键）：

  • 粘贴：即使在已选择不参与的笔记中，也应按照规则进行粘贴。
  • 不进行处理直接粘贴：将剪贴板中的内容原样粘贴。
  • 清理选定内容：对选中的文本应用文本规则。
  • 切换自动清理功能：拨动主开关。

6 值得了解

  • 将内容粘贴到代码块、内联代码或前置信息中不会产生任何影响，而粘贴内容中的围栏代码也会原样保留。
  • 截图和其他仅限位图的粘贴内容则交由 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 关于

我是约翰·桑内布拉德。我拥有软件开发领域的博士学位，曾为苹果、艺电、谷歌、微软、乐高、SKF、沃尔沃汽车、沃尔沃集团和雅马哈等公司从事创新开发工作。此外，我还开发了“Notebook Navigator”——这是 Obsidian 最受欢迎的文件管理器插件。

欢迎在领英上与我建立联系！


10个问题或疑虑？

请在GitHub 仓库中提交一个问题。对于粘贴类 bug，您提供的最有价值的信息是剪贴板中的内容：请在您进行复制操作的应用程序中打开https://dynalist.io/clipboard，将内容粘贴到该页面，并附上页面显示的结果。

不接受拉取请求；请以功能请求的形式提交您的想法。详情请参阅CONTRIBUTING.md。


11 许可

GNU 通用公共许可证 v3.0。参见LICENSE 文件。