Better Paste Documentation - Obsidian Plugin Guide

1 インストール

obsidian.mdからObsidian をインストールする
「設定」の「コミュニティプラグイン」でコミュニティプラグインを有効にする
「Better Paste」をインストールする：「参照」をクリックし、「Better Paste」を検索してから、「インストール」をクリックします。

2 機能の概要

10の例です。中には、貼り付けるたびに実行されるものもあれば、必要なときに実行するコマンドもあります。

2.1 カスタムスニペット

正規表現を使って独自の検索・置換ルールを作成すれば、貼り付けるたびにそのルールが実行されます。これは、Perplexityの引用マークを削除するルールです：

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

～になる

The fix shipped last week and rollout begins today.

このプラグインには、編集や無効化が可能な2つのスニペットが付属しています。「見出しの太字を解除」と「空白行を折りたたむ」です。Wikiには、ChatGPTの数学式を変換するなど、インポート可能な他のスニペットも掲載されています。ルールの記述方法については、セクション3.5を参照してください。

2.2 Safariからの画像

Safariで「画像をコピー」を使用すると、クリップボードには画像自体とそのウェブアドレスの2つのバージョンが保存されます。Obsidianはアドレスを貼り付けますが、ユーザーは画像をコピーしたのだから画像が貼り付けられることを期待しています。「Better Paste」は、画像を「Vault」に保存した上で、その画像を貼り付けます：

![](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をそれぞれ1行ずつ貼り付けると、それぞれにタイトルが付きます。

取得されたタイトルは、· 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つのスイッチで対応しています。ページ番号を削除するか、すべてを1つの段落にまとめるかを選択できます。選択内容は次回のために記憶されます。

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節で説明した、ノートごとの切り替え機能です。Vault内の他の項目と名前が重複する場合は、名前を変更してください。無効にする場合は、空欄のままにしてください。

3.2 添付ファイル

Web画像：貼り付け先がWeb上の画像へのリンク（画像URLのみ、またはコピーされたWebコンテンツ内）である場合、どのように処理されるか。「プレビュー付きリンク」（デフォルト設定）を選択すると、Webから直接画像を表示する埋め込みコードが貼り付けられます。「プレビュー付きダウンロード 」を選択すると、添付ファイルの設定先に応じて、ソースファイル名と同じ名前でコピーがVaultに保存されるため、image.png といった形式のURLは不要になります。「何もしない」を選択すると、画像の貼り付けはObsidianに任されます。ブラウザでコピーされた画像はクリップボードに実際の画像が保存されているため、「プレビュー付きリンク」および「プレビュー付きダウンロード」の両方で、その画像がVaultに保存されます（例2.2を参照）。
貼り付けられたファイル：PDFやスクリーンショットなど、デバイスからファイルを貼り付けた場合の様子です。「何もしない」（デフォルト設定）を選択すると、貼り付けはObsidianに任され、プレビューも表示されます。「プレビューなしのリンク」を選択すると、代わりにプレーンなリンクが挿入されます。つまり、![[Document.pdf]] は[[Document.pdf]] となります。ファイルは、Obsidianの添付ファイル設定に従って保存されます。
ファイル名：{{name}}-YYYY-MM-DD のような独自の形式を追加してください。また、メモ名には{{noteName}} 、フロントマターのプロパティには{{property:xyz}} 、連番には{{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 のように、カンマ区切りのリストを独自に定義し、すべての画像に同じ値を適用するか、貼り付けのたびに「Ask」を選択して小さなダイアログからその都度選択するように設定できます（Enterキーを押すと適用され、前回選択した値が事前選択されます）。#invert のようなクラスは、テーマや CSS スニペットによって定義されます。例えば、ダークモードで画像を反転させる場合などです。「Image width」プロパティ（デフォルト：image-width ）は、ノートごとの幅を設定します。詳細はセクション 4 を参照してください。

代替テキストは保持され、ダウンロードに失敗した場合でも、元のリンクはノート内に残ります。50 MBを超える画像や、表示に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 の両方に一致します。組み込みの削除対象はすべて確認でき、そのファイルへの更新はプラグインのリリースとともに提供されます。削除対象を提案する際は、リストが入力済みの betterpaste.md を開いてください。そこで内容を確認した後、メールアプリで下書きを開いてください。暗号的に署名されたリンクは変更されません。共有ファイルやギフト記事は、アクセスパラメータを維持します。

! で行を始めると、1つのサイトについて組み込みの削除機能を無効にできます：

!youtube.com

3.4 テキスト処理

周囲の空白を削除：貼り付け部分の周囲にある空白行や余分なスペースを削除します。中央にある空白行は残ります。
不可視文字：ゼロ幅スペースを削除し、非改行スペースを通常のスペースに変換します。絵文字、ペルシャ語およびアラビア語の接合文字、CJKのスペースはそのまま残されます。
引用符：カーリークォートやアポストロフィをストレートクォートに変換します。たとえば、「“don’t” 」は「"don't" 」になります。デフォルトではオフになっているため、有効にするまで元の表記が維持されます。
ダッシュ：enダッシュとemダッシュをハイフンに変換します。こちらもデフォルトではオフになっています。コード、リンク、および注記名に含まれる引用符やダッシュは変更されません。

3.5 カスタム処理

テキストスニペット：独自の正規表現ルールで、組み込みルールが適用された後の貼り付け内容全体に対して実行されます。各スニペットには独自のスイッチがあり、リストの順序通りに実行されるため、ドラッグして順序を変更できます。「見出しから太字を削除」と「空白行を折りたたむ」はプラグインに標準で含まれています。
リンクのスニペット：同様のルールが、貼り付けられたリンクのタイトルが取得されると、そのリンクごとに1回ずつ適用されます。このルールは、完成したMarkdown形式のリンクを認識し、URL自体は変更されません。「タイトルからサイト名を削除」機能はプラグインに標準で含まれており、· GitHub や- YouTube といった末尾部分を切り取ります。
ルールは、1行につき1つのJavaScript正規表現置換で構成され、s/find/replace/flags という形式をとります。# で始まる行はコメントです：

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

試してみてください：サンプルテキストを入力すると、有効になっているすべてのスニペットがそのテキストに対してリアルタイムで実行される様子を確認できます。リンクスニペットには、Markdown形式のリンクを受け付ける専用のテスターが用意されています。スニペットエディタでは、作成中のスニペットについても同様のプレビューが表示されます。
スニペット****のインポートとエクスポート：クリップボードを介して、スニペットを各ボールト間で移動します。既製のスニペットはWikiに掲載されていますので、そこからコピーして貼り付けてください。
正規表現プレイグラウンドを開く：regex101を開き、検索パターンの作成やテストを行うためのルールが設定された画面が表示されます。

3.6 構造

貼り付け時のリストのネストを維持する：デフォルトではオンになっています。上記の例 2.5 を参照してください。
貼り付け時にブロック引用を継続する：これもデフォルトでオンになっています。上記の例 2.6 を参照してください。

構造ルールは、テキストルールよりも後に実行されます。これは、構造ルールがカーソルの周囲の注釈を読み取り、クリーン化されたテキストをそれに合わせて再構成するためです。

4 音符ごとの制御

ノートのフロントマターに「bp: false 」を追加すると、Better Pasteはそのノートを対象外にします。ログやトランスクリプトに最適です：

---
bp: false
---

その逆も同様です。「bp: true 」を実行すると、「貼り付けのたびにクリーンアップ」がオフになっている場合でも、ノートがクリーンアップされます。

すべての貼り付けを削除する	`bp` プロパティなし	`bp: true`	`bp: false`
オン	クリーンアップ済み	cleaned	そのまま
オフ	そのままにしておく	掃除済み	放置された

また、image-width と指定すると、そのノートに貼り付けられた画像の幅が設定されます：

---
image-width: 400
---

画像は、Obsidian独自のサイズ表記である「![[picture.png|400]] 」という形式で出力されます。「400x300 」も同様に機能します。

5つのコマンド

9つのコマンドが用意されており、お好みのホットキーを設定できます（「設定」→「ホットキー」）。IDは、CommanderなどのURIスキームやプラグイン用のもので、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 知っておくと役立つ情報

コードブロック、インラインコード、またはフロントマター内に貼り付けられたテキストは変更されず、ペースト内のフェンス付きコードもそのまま反映されます。ただし、1つ例外があります。「Web画像」の設定が「プレビュー付きでダウンロード」になっている場合、ソースモードで空のプロパティに画像のURLを貼り付けると、その画像は"[[skyline-8f21a.jpg]]" というプロパティが設定された状態でVaultに保存されます。Obsidian Basesではこれをカバー画像として表示でき、ローカルコピーはオフラインでも利用可能です。
スクリーンショットは「Better Paste」によって保存されます。ファイル名の形式を独自に設定していない限り、Obsidianが割り当てるのと同じ名前で保存されます。
リッチコンテンツ（HTML）は、まずObsidianによってMarkdownに変換されます。その後、Better Pasteがリンクを整理し、結果として得られた画像に「Web画像」の設定を適用します。

7つの言語

Better Paste は、アラビア語、中国語（簡体字）、中国語（繁体字）、オランダ語、英語、フランス語、ドイツ語、インドネシア語、イタリア語、日本語、韓国語、ペルシャ語、ポーランド語、ポルトガル語、ポルトガル語（ブラジル）、ロシア語、スペイン語、タイ語、トルコ語、ウクライナ語、ベトナム語の計 21 言語に対応しています。 Obsidianで設定されている言語に準じます（変更は再起動後に反映されます）。

8 プライバシー

Better Pasteはローカルで実行され、ネットワークリクエストを行うのは、以下の3つのケースに限られます：

貼り付けた画像をダウンロードする
貼り付けたリンクのタイトルを取得します（この機能を停止するには、「貼り付けたリンクのタイトルを取得する」をオフにしてください）
GitHubから「ウェルカム」ダイアログおよび「新着情報」ダイアログのアートワークを読み込む

テレメトリも分析機能もなく、データがアップロードされることも一切ありません。設定は.obsidian/plugins/better-paste/data.json に保存され、お客様のVault内に留まります。

すべてのリリースについては、TypeScript、Obsidian公式ESLintプラグインを使用したESLint、Stylelint、Prettier、Vitest、およびデッドコードチェックによる検証が行われます。警告が発生した場合は、ビルドが失敗します。

9 概要

私はヨハン・サンネブラッドと申します。ソフトウェア開発の博士号を取得しており、Apple、Electronic Arts、Google、Microsoft、レゴ、SKF、ボルボ・カーズ、ボルボ・グループ、ヤマハなどの企業でイノベーション開発に携わってきました。また、Obsidianで最も人気のあるファイルエクスプローラープラグイン「Notebook Navigator」の開発も手がけています。

LinkedInでぜひつながりましょう！

10の質問や疑問点はありますか？

GitHubリポジトリでイシューを作成してください。貼り付けに関するバグの場合、最も役立つ情報はクリップボードに保存されていた内容です。コピー元となったアプリでhttps://dynalist.io/clipboardを開き、そこに貼り付けて、表示された内容を含めてください。

プルリクエストは受け付けておりません。アイデアは機能リクエストとしてご提案ください。詳細については、CONTRIBUTING.mdをご覧ください。

11 ライセンス

GNU General Public License v3.0。LICENSE を参照してください。