Better Paste Documentation - Obsidian Plugin Guide

1. 설치

obsidian.md에서Obsidian을 설치하세요
‘설정’ >‘커뮤니티 플러그인’에서 커뮤니티플러그인을 활성화하세요.
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을 붙여넣기만 하면 실제 페이지 제목이 포함된 마크다운 링크로 변환됩니다:

https://obsidian.md

~가 된다

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

URL은 즉시 붙여넣어지며 제목이 도착하면 업데이트되므로, 아무런 지연도 발생하지 않습니다.

링크 목록도 가능합니다. 여러 개의 URL을 각 줄에 하나씩 붙여넣으면, 모든 링크에 제목이 자동으로 지정됩니다.

검색된 제목은 대개 · GitHub 이나 - YouTube 처럼 사이트 이름으로 끝나는 경우가 많습니다. 포함된 ‘제목에서 사이트 이름 제거’ 링크 스니펫은 이러한 부분을 잘라내며, 사용자는 직접 규칙을 추가할 수도 있습니다. 자세한 내용은 3.5절을 참조하십시오.

Reddit, YouTube, TikTok 및 Loom은 일반적인 페이지 조회 기능을 차단하므로, 해당 사이트의 제목은 각 사이트의 자체 임베드 서비스를 통해 가져오며, Stack Overflow 및 기타 Stack Exchange 사이트의 제목은 Stack Exchange API를 통해 가져옵니다. Dropbox 공유 링크의 경우 파일 또는 폴더 이름이 제목으로 사용되며, Obsidian URL의 경우 노트 이름이 제목으로 사용됩니다.

2.5 중첩된 목록

중첩된 목록을 복사하여 다른 목록의 깊은 곳에 붙여넣으면, 기존 들여쓰기가 그대로 적용되어 목록 구조가 깨집니다. ‘Better Paste’는 붙여넣은 항목에 맞춰 전체 목록의 들여쓰기를 다시 조정합니다. 예를 들어:

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

의 빈 항목에 붙여넣기

- Projects
    - Summer
        -

~가 된다

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

글머리 기호, 번호 매기기 목록, 체크박스는 대상 위치가 아무리 깊게 들어가고, 복사본에 탭이나 공백이 사용되었는지 여부와 관계없이 정상적으로 작동합니다. 순수한 목록이 아니거나 목록 항목에 위치하지 않는 붙여넣기는 이전과 똑같이 처리됩니다. 웹 페이지에서 복사한 리치 텍스트는 대신 Obsidian의 HTML 변환 과정을 거칩니다.

2.6 인용문

여러 단락을 블록 인용문에 붙여넣으면 첫 줄만 인용되는 현상은 수년 동안 Obsidian에서 지속되어 온 문제입니다. Better Paste는 붙여넣은 모든 줄을 인용 처리하므로, 붙여넣은 내용 전체가 인용문 안에 포함됩니다. 예를 들어:

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 터미널 출력

터미널은 창 가장자리에서 긴 줄을 끊어 표시합니다. 붙여넣기를 할 때마다 이스케이프 코드가 제거되며, 붙여넣은 출력을 선택하고 ‘터미널 출력 정리’를 실행하면 줄들이 다시 이어집니다:

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.

‘ﬁ’와 같은 합자 기호도 실제 문자로 인식되므로, 검색 시 해당 단어가 다시 검색됩니다.

이 명령을 실행하면 미리보기가 포함된 대화 상자가 열리므로, 결과가 적용되기 전에 미리 확인할 수 있습니다. 두 가지 설정 옵션을 통해 규칙으로는 예측할 수 없는 부분을 처리할 수 있습니다. 바로 페이지 번호를 제거하거나, 모든 내용을 하나의 단락으로 합치는 것입니다. 선택한 설정은 다음 번에도 그대로 유지됩니다.

2.9 AI가 생성한 텍스트 정리

챗봇 텍스트에는 곡선 따옴표, 긴 대시 및 보이지 않는 문자가 포함되어 있습니다. 보이지 않는 문자는 붙여넣을 때마다 제거되며, ‘따옴표 및 대시’ 옵션이 켜져 있으면 나머지 내용도 일반 텍스트로 변환됩니다:

“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}}, 순차적으로 증가하는 번호에는 {{counter}} 또는 {{counter:2}} 을 사용할 수 있습니다. 스크린샷에는 소스 이름이 없으므로, Obsidian에서 부여하는 이름과 동일하게 Pasted image 에 타임스탬프가 추가된 이름이 부여됩니다. 노트에 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’ 속성 (기본값: image-width)은 노트별 너비를 설정합니다. 자세한 내용은 4절을 참조하십시오.

대체 텍스트는 그대로 유지되며, 다운로드에 실패하더라도 원본 링크는 노트에 남아 있습니다. 50MB를 초과하거나 다운로드에 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 는 mine.example 및 그 하위 도메인에서 source 와 ref 를 제거하는 반면, 다른 모든 매개변수는 그대로 유지합니다. 또한 google.* 는 google.com과 google.se 모두에 동일하게 적용됩니다. 모든 내장 제거 항목을 확인할 수 있으며, 해당 파일의 업데이트는 플러그인 릴리스와 함께 제공됩니다. 제거할 항목을 제안할 때는 목록이 미리 채워진 opens betterpaste.md 파일을 열어주세요. 거기서 내용을 검토한 후, 이메일 앱에서 초안을 작성하세요. 암호학적으로 서명된 링크는 변경되지 않습니다. 공유 파일과 선물 기사는 액세스 매개변수를 유지합니다.

! 로 시작하는 줄을 추가하여 특정 사이트에 대한 내장 제거 기능을 비활성화하세요:

!youtube.com

3.4 텍스트 처리

주변 공백 정리: 붙여넣은 내용 주변의 빈 줄과 불필요한 공백을 제거합니다. 중간에 있는 빈 줄은 그대로 유지됩니다.
보이지 않는 문자: 너비 0인 공백을 제거하고, 비분리 공백을 일반 공백으로 변환합니다. 이모지, 페르시아어 및 아랍어 연결 문자, CJK 간격은 그대로 유지됩니다.
따옴표: 곡선 따옴표와 아포스트로피를 직선 따옴표로 변환합니다. 따라서 “ “don’t” ”는 “ "don't" ”로 바뀝니다. 기본적으로 비활성화되어 있으므로, 사용자가 직접 활성화하기 전까지는 기존 서식이 유지됩니다.
대시: en 대시와 em 대시를 하이픈으로 변환합니다. 이 기능도 기본적으로 비활성화되어 있습니다. 코드, 링크 및 노트 이름 내의 따옴표와 대시는 그대로 유지됩니다.

3.5 사용자 지정 처리

텍스트 스니펫: 사용자 정의 정규식 규칙으로, 내장 규칙 적용 후 붙여넣은 전체 텍스트에 적용됩니다. 각 스니펫에는 고유한 스위치가 있으며, 목록 순서대로 실행되므로 드래그하여 순서를 변경할 수 있습니다. 제목에서 굵은 글씨 제거 및 빈 줄 접기 기능은 플러그인에 기본으로 포함되어 있습니다.
링크 스니펫: 동일한 종류의 규칙으로, 붙여넣은 링크의 제목이 등록되면 해당 링크에 대해 한 번씩 적용됩니다. 이 규칙은 완성된 마크다운 링크를 인식하며, 주소는 변경되지 않습니다. ‘제목에서 사이트 이름 제거’ 기능은 플러그인에 기본으로 포함되어 있으며, · GitHub 이나 - YouTube 과 같은 끝부분을 잘라냅니다.
규칙은 한 줄에 하나의 자바스크립트 정규식 대체 문으로 구성되며, 형식은 s/find/replace/flags 와 같습니다. # 로 시작하는 줄은 주석입니다:

# Remove Perplexity citations
s/\[\d+\]//g

한 번 해보세요: 예시 텍스트를 입력하면 활성화된 모든 스니펫이 해당 텍스트를 대상으로 실시간으로 실행되는 모습을 확인할 수 있습니다. 링크 스니펫에는 마크다운 링크를 입력할 수 있는 전용 테스터가 있습니다. 스니펫 편집기에서도 작성 중인 스니펫에 대해 동일한 미리보기를 확인할 수 있습니다.
스니펫****가져오기 및 내보내기: 클립보드를 통해 볼트 간에 스니펫을 이동할 수 있습니다. 미리 만들어진 스니펫은 위키에 있습니다. 거기서 하나를 복사하여 붙여넣으세요.
정규식 플레이그라운드 열기: 정규식101의 규칙에 따라 구성된 환경을 열어, 검색 패턴을 작성하고 테스트할 수 있습니다.

3.6 구조

붙여넣기 시 목록 중첩 유지: 기본적으로 켜져 있습니다. 위의 예제 2.5를 참조하십시오.
붙여넣기 시 블록 인용문 이어서 표시: 이 기능도 기본적으로 켜져 있으며, 위의 예 2.6을 참조하십시오.

구조 규칙은 텍스트 규칙보다 나중에 실행되는데, 이는 커서 주변의 주석을 읽어들이고 정리된 텍스트를 그에 맞게 재구성하기 때문입니다.

4. 음표별 제어

노트의 프론트매터에 ` bp: false `를 추가하면 Better Paste가 해당 노트를 건드리지 않습니다. 로그나 대본을 관리할 때 안성맞춤입니다:

---
bp: false
---

반대의 경우도 마찬가지입니다. ‘ bp: true ’는 ‘Clean up every paste’가 꺼져 있어도 노트를 정리해 줍니다.

모든 붙여넣기 내용 정리하기	`bp` 속성이 없음	`bp: true`	`bp: false`
다음에서	정리된	cleaned	건드리지 않음
Off	그대로 둠	청소됨	방치된

그리고 image-width 는 해당 노트에 붙여넣은 이미지의 너비를 설정합니다:

---
image-width: 400
---

이미지는 Obsidian 고유의 크기 표기법인 ![[picture.png|400]] 형식으로 표시됩니다. 400x300 도 작동합니다.

5가지 명령어

9가지 명령어로, 사용자 지정 단축키를 설정할 수 있습니다(설정, 단축키). ID는 URI 스키마 및 Commander와 같은 플러그인을 위한 것으로, better-paste: 접두사가 붙습니다.

붙여넣기 (paste): 규칙을 적용하여 붙여넣기하며, 적용 제외를 선택한 노트에서도 마찬가지입니다.
처리 없이 붙여넣기 (paste-raw): 클립보드에 있는 내용을 그대로 붙여넣습니다.
선택 영역 정리 (selection-clean): 선택한 텍스트에 텍스트 규칙을 적용합니다.
터미널 출력 정리 (selection-clean-terminal): 선택 영역에서 줄바꿈된 줄을 다시 연결하고, 앞쪽 들여쓰기를 제거하며, • 의 글머리 기호를 마크다운 목록으로 변환합니다. 이 작업은 사용자가 요청할 때만 수행되며, 해당 텍스트가 터미널에서 나온 것임을 아는 사람은 사용자 본인뿐이기 때문입니다.
PDF 텍스트 정리 (selection-clean-pdf): PDF 레이아웃으로 인해 짧아진 줄을 다시 연결하고, 하이픈으로 나뉜 단어를 수정하며, 선택 영역 내의 합자(ligature)를 확장합니다. 대화 상자에서 결과를 미리 볼 수 있으며, 페이지 번호 및 단락 관련 옵션을 설정할 수 있습니다.
스니펫 실행 (selection-run-snippet): 스니펫을 선택하여 선택 영역에 적용할 수 있으며, 붙여넣기 기능이 비활성화된 스니펫도 적용 가능합니다.
따옴표 안으로 쉼표 이동 (selection-commas-inside) 및 따옴표 밖으로 쉼표 이동 (selection-commas-outside): 닫는 따옴표 옆에 쉼표를 배치하는 스타일로, 선택한 부분에 적용됩니다.
자동 정리 기능 켜기/끄기 (toggle-cleanup): 마스터 스위치를 전환하세요.

6. 알아두면 좋은 정보

코드 블록, 인라인 코드 또는 프론트매터 내에 붙여넣은 텍스트는 변경되지 않으며, 붙여넣기 내용 내의 펜스 코드도 그대로 유지됩니다. 단, 한 가지 예외가 있습니다. 웹 이미지가 '미리보기와 함께 다운로드'로 설정된 경우, 소스 모드에서 빈 속성에 이미지 주소를 붙여넣으면 해당 이미지가 속성이 "[[skyline-8f21a.jpg]]" 로 설정된 상태로 볼트에 저장됩니다. Obsidian Bases에서는 이를 표지 이미지로 표시할 수 있으며, 로컬 사본을 통해 오프라인에서도 사용할 수 있습니다.
스크린샷은 Better Paste에 의해 저장되며, 사용자가 별도의 파일 이름 형식을 설정하지 않는 한 Obsidian이 부여하는 이름과 동일한 이름으로 저장됩니다.
리치 콘텐츠(HTML)는 먼저 Obsidian에서 마크다운으로 변환되며, 이후 Better Paste가 링크를 정리하고 결과물의 이미지에 웹 이미지 설정을 적용합니다.

7개 언어

Better Paste는 아랍어, 중국어(간체), 중국어(번체), 네덜란드어, 영어, 프랑스어, 독일어, 인도네시아어, 이탈리아어, 일본어, 한국어, 페르시아어, 폴란드어, 포르투갈어, 포르투갈어(브라질), 러시아어, 스페인어, 태국어, 터키어, 우크라이나어, 베트남어 등 21개 언어를 지원합니다. 이 기능은 Obsidian의 설정 언어에 따라 결정되며(설정 변경은 재시작 후 적용됩니다).

8. 개인정보 보호

Better Paste는 로컬에서 실행되며, 정확히 다음 세 가지 경우에만 네트워크 요청을 수행합니다:

붙여넣은 이미지 다운로드하기
붙여넣은 링크의 제목을 가져옵니다(이 기능을 중지하려면 ‘붙여넣은 링크의 제목 가져오기’를 해제하세요).
GitHub에서 ‘환영’ 및 ‘새로운 소식’ 대화 상자의 아트웍 불러오기

텔레메트리도, 분석 데이터도 없으며, 어떤 정보도 업로드되지 않습니다. 설정은 .obsidian/plugins/better-paste/data.json 에 저장되며, 사용자의 볼트 내에 안전하게 보관됩니다.

모든 릴리스는 TypeScript, 공식 Obsidian ESLint 플러그인을 사용한 ESLint, Stylelint, Prettier, Vitest 및 사멸 코드 검사를 통해 검증됩니다. 경고가 발생하면 빌드가 실패합니다.

9. 소개

저는 요한 산네블라드입니다. 소프트웨어 개발 분야에서 박사 학위를 취득했으며, 애플, 일렉트로닉 아츠, 구글, 마이크로소프트, 레고, SKF, 볼보 자동차, 볼보 그룹, 야마하 등 다양한 기업에서 혁신 개발 업무를 담당해 왔습니다. 또한, 오브시디언(Obsidian)에서 가장 인기 있는 파일 탐색기 플러그인인 ‘노트북 네비게이터( Notebook Navigator)’를 개발하고 있습니다.

LinkedIn에서 언제든지 저와 연결해 주세요!

질문이나 문의 사항이 10가지나 있으신가요?

GitHub 저장소에 이슈를 등록해 주세요. 붙여넣기 관련 버그의 경우, 클립보드에 있던 내용을 함께 제공해 주시면 가장 도움이 됩니다. 복사한 앱에서 https://dynalist.io/clipboard을 열고, 해당 페이지에 내용을 붙여넣은 뒤, 화면에 표시되는 내용을 함께 첨부해 주세요.

풀 리퀘스트는 접수하지 않습니다. 대신 기능 요청 형태로 아이디어를 제안해 주세요. 자세한 내용은 CONTRIBUTING.md를 참조하세요.

11. 라이선스

GNU 일반 공중 사용 허가서 v3.0. LICENSE 파일을 참조하십시오.