スニペット
スニペットは、短い略語が全文になるものです。プレーンテキスト、リッチテキスト（HTML）、または実行可能なスクリプト（Pro）。数文字 + トリガーキー → 全文ブロック。{{date}}、{{clipboard}}（Pro）などのテンプレート変数は展開時に置換されます。FillIn と変数 を参照。
メインウィンドウは三欄です。左がグループ、中央がスニペット一覧、右がエディタ。ロックされた組織グループはデスクトップでは編集できません。
Main window: groups → snippets → editor. Organization groups are locked read-only.
スニペットの展開方法
- 略語とトリガー — 略語 + トリガー（既定 Tab、または Space/Enter など）で展開。任意のテキスト欄で動く。
- トリガーキー：Tab、Space、Enter、Alt、
.、,、;、-、/、=、`が設定可。「展開にトリガーが必要」を推奨し、誤発動を減らす。 - マッチモード：
- 左から右：略語は入力と完全一致が必要（例：
sig→sig+Tab） - 右から左：略語は末尾一致だけでよい（例：
mysig→sig+Tab で展開） - 単語境界：右から左モードで、略語の前に単語境界文字を要求し、単語の途中での発動を避ける
- 大文字小文字の追従：
SIGと打つと大文字版、Sigと打つとタイトルケース
- 左から右：略語は入力と完全一致が必要（例：
- インライン検索：
//（接頭辞は設定可）でスニペット検索ポップアップ。矢印で選び、Enter で挿入 - ショートカット（Pro）：グローバルなメイン / 検索、クリップボードから作成、新規スニペット、最後に展開したものを編集、最後をもう一度展開。スニペットごとのグローバルショートカット。設定 → ショートカット を参照。
グループと複数ファイル
- ツリーグループ + 接頭辞：例として
ai-以下はai-xxxで展開。用途ごとに多数のスニペットを管理。はじめに · スニペット を参照。 - 複数ファイルスニペット：1 スニペット、複数の「ファイル」（言語 / 環境）。それぞれ独自の略語と内容。一度メンテして、どこでも展開。
- ファイルの追加、コピー、削除、ドラッグ並べ替え
- 各ファイルが独立して持つもの：ファイル名、ランタイム、略語、内容、展開範囲、グローバルホットキー
- 複数ファイルスニペットは一覧にファイル数バッジを表示
選んだアプリだけで ᴾᴿᴼ
選んだアプリ内だけで展開。同じ略語を他で打っても発動しません。VS Code、Cursor、ブラウザでは展開し、チャットや Web 入力では発動しません。
設定方法
- スニペットまたはグループ設定を開く。
- ExpandIn（または「これらのアプリ内だけで展開」）を見つける。
- アプリを選ぶか検索（例：VS Code、Chrome、Cursor）。複数可。
- 保存。そのスニペットまたはグループは、それらのアプリでの「略語 + トリガー」にだけ応答する。
アプリを選ばなければ、どこでも適用されます。
仕組み
- アプリ検出：前面アプリを自動識別。技術設定は不要。
- グループ単位の制限：グループに ExpandIn を付けると、配下の全スニペットに効く。
- スニペット単位の制限：スニペット設定がグループを上書きし、より細かく制御できる。
- グローバル検索：ExpandIn が影響するのは「略語 + トリガー」展開だけ。グローバル検索ウィンドウ（ショートカット起動）はどこでも使える。
典型的な場面
| 場面 | おすすめの設定 |
|---|---|
| IDE だけのコードスニペット | グループを VS Code / Cursor / JetBrains のみに。log、try などの略語がチャットアプリで発動しない |
| ブラウザの AI プロンプト | スニペットを Chrome / Safari / Edge のみに。AI チャットサイトでプロンプトを展開 |
| オフィス文書テンプレート | グループを Lark / Notion / Docs のみに。週報と議事録は文書ツールだけで発動 |
| 同じ略語、違うアプリ | 同じ略語がアプリごとに違う内容になる。deploy は Terminal では Shell コマンド、文書ではデプロイ手順テンプレート |
注意
- 認識できないアプリ：検出できないアプリ（一部の Electron アプリ）では ExpandIn が効かないことがある。それらのスニペットでは制限を切る。
- 性能：ExpandIn はトリガーごとに前面アプリを確認する。オーバーヘッドは無視できる。
- 単語境界と組み合わせ：許可アプリ内でも単語途中の発動を避けるなら「単語境界チェック」をオンにする。
向いている人：IDE とブラウザでスニペットを多用し、チャット（WeChat、Slack など）では発動したくない人。
スニペットエディタ
エディタの種類
スニペットのランタイムに応じて自動切替：
- コードエディタ：シンタックスハイライト、行番号、取り消し / やり直し。コードラッパーとスクリプトスニペット向き。
- リッチテキストエディタ：太字、斜体、見出し、リスト、表、画像、リンク。メールテンプレートと書式付き内容向き。
エディタツールバー
| ショートカット | 操作 |
|---|---|
Cmd/Ctrl+Shift+L | 読み取り専用 / 編集モードの切替 |
Cmd/Ctrl+Shift+P | スニペットの実行 / プレビュー |
Cmd/Ctrl+Shift+Backspace | 現在のファイルを削除 |
読み取り専用のヒント：スニペットがロック（読み取り専用）のとき、エディタ領域にホバーすると錠アイコンが点滅します。クリックするか Cmd/Ctrl+Shift+L で解除して編集。
典型的な場面
- 開発者：シンタックスハイライト付きでコードラッパー（try/catch、ログ）を書く。スクリプトを直接実行して出力をコピー。
- テクニカルライター：画像と表付きのリッチテキストでドキュメントを下書き。同じアプリでスクリーンショットと注釈。
- 多言語チーム：地域をまたいでスニペットを共有。コードスニペットはどの IDE でも動き、テンプレートは FillIn で現地語に合わせる。
コードを画像に
- Carbon 共有：コードをきれいな画像として描画（Carbon.now.sh）
- ローカル描画：コードを画像に（ローカル描画）
FillIn とテンプレート変数
- FillIn 変数 — 展開時のポップアップ：1行 / 複数行、ドロップダウン、チェックボックス、
%date%、カーソル%c%（複数カーソル tabstop 対応）、クリップボード%cv%、入れ子%s:abbr%。プロンプトとパラメータ付きテンプレート向き。- 変数の大文字小文字整形：
camel/pascal/snake/kebab/upper/lower
- 変数の大文字小文字整形：
- スニペットのテンプレート変数（Pro） — 本文内：
{{date}}、{{time}}、{{clipboard}}、{{cursor}}、{{input}}。展開時に置換。
スニペット種別と実行 ᴾᴿᴼ
組み込み種別
| 種別 | 内容 |
|---|---|
plain | プレーンテキスト（既定） |
rich | リッチテキスト（HTML） |
shell | Shell スクリプト |
applescript | AppleScript（macOS） |
js | JavaScript |
powershell | PowerShell（Windows） |
python | Python |
カスタムランタイム
設定でカスタムランタイムを構成し、任意の実行ファイルを動かせます。スニペット本文、クリップボード、選択テキストを実行コンテキストへ渡せます。前後処理用のカスタムラッパーテンプレートもあります。
実行方法
- プレビュー：実行ボタンをクリック、またはエディタで
Cmd/Ctrl+Shift+P。結果は下部パネル - 実行してコピー：スニペット一覧を右クリック → 「実行してコピー」。実行後に結果がクリップボードへ
バージョン履歴
ファイルごとの自動保存履歴：
- 自動保存：編集中に履歴へ自動保存
- バージョンの由来：初回作成、自動保存、手動保存、適用操作
- 差分：並べて視覚比較。行単位または整形済みの差を確認
- 復元：任意の過去版へワンクリックで戻す
典型的な復旧：
- 誤削除 → 履歴から数秒で復旧
- 変更比較 → 編集間で何が変わったかを正確に見る
- 実験的な編集 → 新しい案を安全に試し、いつでも戻す
グループと接頭辞
左欄はグループツリーです。スニペットはグループに入り、略語はファイルに、接頭辞はグループにあります。
- 空白を右クリック → 新規グループ、またはグループの下に子を追加。
- グループ設定：名前、接頭辞（例：
ai-）。接頭辞ai-+ ファイル略語gen→ai-genと打ってからトリガー。 - 無料：およそ 5 グループ。Pro は無制限。子グループは独自の接頭辞を持てます。変更後は保存。
グループは ExpandIn / expand-when / ローカルのトリガーキー（同期されない）と、アップロードするかどうかも設定できます。ロックされた 組織グループはデスクトップでは編集できません。組織 と 展開 を参照。
作成と編集
サポートが返品ポリシーの一文を ret として欲しいとします。グループを 1 つ選び、スニペットを作り、本文を書いて保存。次からはメールで ret と Tab。
- 自分だけのグループを選ぶ（ロックされた組織グループはここでは編集できない）。
Cmd/Ctrl+N、または新規をクリック。無料はおよそ 50 スニペットで止まる。- 名前を付け、ファイルに 略語と本文を設定。プレーンテキスト、リッチテキスト、またはスクリプト（Pro）を選ぶ。
- 保存。新しい略語やグループ接頭辞は、次に打ったときから効く。
他にも：クリップボードから作成、ファイルをドロップ、提案スニペット を受け入れる、共有パック を開く。1 スニペットに中国語署名と英語署名を持て、それぞれ独自の略語です。
提案スニペット
今日同じ結びを 3 回打ったとします。メインウィンドウが聞くことがあります：これを略語として保存しますか？ プレビューして確認。無視すればライブラリは変わりません。確認すると現在のグループに追加されます。無料のおよそ 50 件上限は適用されます。回数はこのコンピュータに残ります。
共有パック
グループ / スニペットを同僚向けにまとめます。アプリ内で確認し、項目は相手のローカルライブラリに入ります。ライブの組織同期ではありません。
codeexpander://import?d=...を開く（長すぎるペイロードは拒否される）。- デコード後、アプリが確認ダイアログを出す。同意してから書き込む。無料帯の上限は適用される。
- 共有の組織スニペットを指すパックは認識される。自分のライブラリへコピーで、編集可能な個人コピーになる。
書き出しはスニペット / グループメニューと データ → 転送にあります。共有パックは CE Cloud の組織アクセスではありません。ディープリンク を参照。
共有と同期
- 個人 CE Cloud / 組織 / Gist と WebDAV。
- インポート / エクスポート：設定 → データ。JSON と TextExpander 書き出し。