Insert Callout

by nonkuri
5
4
3
2
1
Score: 50/100
Trending Plugin

Description

Obsidian plugin: insert a callout at the cursor or around the selection, with a type-selection dialog

Reviews

No reviews yet.

Stats

0
stars
106
downloads
0
forks
26
days
26
days
26
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
8
commits

Latest Version

a month ago

Changelog

Fixes the obsidianmd/no-unsupported-api error reported by the community directory review.

Breaking

  • Obsidian 1.13.0 or later is now required (minAppVersion was 1.0.0). The settings tab is rendered entirely from the declarative settings API, which is only available on 1.13.0+, so the deprecated display() fallback was removed. Version 1.3.0 remains available for older Obsidian versions.

Full Changelog: https://github.com/nonkuri/insert-callout/compare/1.3.0...1.3.1

README file from

Github

Insert Callout

An Obsidian plugin that quickly inserts callouts in two ways: a type-selection dialog command, and autocomplete that pops up when you type [! in a quote block. In both, the suggestions are ordered by most recently used. A second command removes a callout again, stripping the quote markers with it.

日本語の説明はこちら

Features

  • Run the Insert command (shown as Insert Callout: Insert) to open a suggestion dialog for the callout type
    • Filter by typing (e.g. wa → warning), pick with ↑/↓ + Enter or a mouse click
    • Recently used types appear at the top of the list, so pressing Enter reuses the last one
  • Autocomplete in quote blocks: typing [! right after > pops up the same suggestion list
    • Keep typing to narrow down the candidates (e.g. [!wa → warning)
    • Selecting a candidate inserts the complete callout heading (e.g. [!warning] )
    • Candidates are ordered by most recently used
  • No selection: the cursor line is turned into a callout and the cursor is placed in the body
  • With selection: the selected lines become the body of the callout
  • Run the Remove command (shown as Insert Callout: Remove) to undo it: the heading line is removed and the quote markers are stripped as well (see Removing a callout)

The inserted callout is the simple form (type only, no fold marker):

> [!note]
> body text

Removing a callout

Run the Remove command with the cursor anywhere inside a callout:

  • The > [!type] heading line is deleted, and one level of quote markers is stripped from the rest of the block — so a plain callout becomes plain text, quoting included
  • If the heading has a title (> [!note] Title), the title is kept as the first body line
  • Nested quotes lose one level only (> > text> text)
  • It also works on a plain quote block with no callout heading, which simply unquotes it
  • The whole quote block around the cursor is processed, even if only part of it is selected
> [!note]        →   body text
> body text

Settings

  • Callout types: edit the types shown in the dialog and their order, one type per line. Custom callout names are also allowed.
  • Don't insert the closing bracket (default: on): when autocompleting, an existing ] right after the cursor is not duplicated. Keep this on if Obsidian auto-pairs [ with ].
  • Reset to defaults: restores the 13 built-in Obsidian types (note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example, quote).

Installation (manual)

Requires Obsidian 1.13.0 or later. Copy the following files into .obsidian/plugins/insert-callout/ in your vault, then enable the plugin under Settings → Community plugins:

  • main.js
  • manifest.json
  • styles.css

Development

npm install
npm run build   # type check + build main.js
npm run dev     # watch build

License

MIT


Insert Callout (日本語)

Obsidian に Callout を素早く挿入するプラグイン。種類選択ダイアログを開くコマンドと、 引用ブロック内で [! と入力すると表示されるオートコンプリートの2つの方法があり、 どちらも候補は最近使った順に並ぶ。引用ごと Callout を解除するコマンドもある。

機能

  • コマンド Insert(表示は Insert Callout: Insert)を実行すると、Callout の種類を選ぶダイアログが開く
    • 文字入力で絞り込み(例: wa → warning)、↑↓ + Enter またはクリックで決定
    • 最近使った種類がリスト先頭に表示され、Enter だけで再利用できる
  • 引用ブロック内のオートコンプリート: > の直後に [! と入力すると候補リストが表示される
    • 続けて入力すると候補が絞り込まれる(例: [!wa → warning)
    • 候補を選択すると完全な Callout 見出しが挿入される(例: [!warning] )
    • 候補は最近使った順に並ぶ
  • 選択範囲がない場合: カーソル行を Callout に変換し、カーソルを本文位置にセット
  • 選択範囲がある場合: 選択した行(複数行可)を Callout の本文に変換
  • コマンド Remove(表示は Insert Callout: Remove)で解除できる。見出し行を削除し、引用マーカーも剥がす (詳細は Callout の解除)

挿入されるのは種類のみのシンプルな形式(折りたたみ記号なし):

> [!note]
> 本文

Callout の解除

Callout 内にカーソルを置いてコマンド Remove を実行する。

  • > [!type] の見出し行を削除し、残りの行から引用マーカーを1段分だけ剥がす。 通常の Callout なら引用状態ごと解除され、ただのテキストに戻る
  • タイトル付き(> [!note] タイトル)の場合、タイトルは本文の1行目として残す
  • ネストした引用は1段だけ浅くなる(> > 本文> 本文)
  • Callout 見出しのない普通の引用ブロックにも使え、その場合は単なる引用解除になる
  • 一部だけ選択していても、カーソル周辺の引用ブロック全体が対象になる
> [!note]        →   本文
> 本文

設定

  • Callout types: ダイアログに表示する種類と順序を、1行1種類のテキストで編集。 カスタム Callout 名も追加可能。
  • Don't insert the closing bracket(デフォルト: オン): オートコンプリートで挿入するとき、 カーソル直後に既にある ] を重複させない。Obsidian が [ の入力時に ] を 自動補完する環境ではオンのままにする。
  • Reset to defaults: Obsidian 組み込みの13種類 (note, abstract, info, todo, tip, success, question, warning, failure, danger, bug, example, quote)にリセット。

インストール(手動)

Obsidian 1.13.0 以降が必要。Vault の .obsidian/plugins/insert-callout/ に以下の3ファイルを置き、 Obsidian の設定 → コミュニティプラグイン で有効化する。

  • main.js
  • manifest.json
  • styles.css

開発

npm install
npm run build   # 型チェック + main.js 生成
npm run dev     # watch ビルド

※ Google Drive 上のフォルダでは npm install が失敗することがあるため、 その場合はローカルディスクにコピーしてビルドし、main.js を戻す。