Skip to content

An Obsidian plugin to quickly add, change, or remove callout wrappers in your notes.

License

Notifications You must be signed in to change notification settings

alythobani/obsidian-callout-toggles

Repository files navigation

Callout Toggles

An Obsidian plugin to quickly add, switch, or remove callouts in your notes. Provides a separate command for every possible callout type, so you can easily assign hotkeys for your favorite callouts.

Switching between callout types demonstration

Features

  • Quickly insert or remove a callout of your choice with a single command
  • Insert a fresh callout, or wrap existing text in a callout
  • Retains custom titles when wrapping or removing callouts
  • Supports custom callouts (automatically syncs with Callout Manager if installed)
  • Configurable settings for default formatting, foldable callouts, and more

Table of contents

  1. Features
  2. Table of contents
  3. Commands provided
    1. Wrap lines in X callout
    2. Remove callout from selected lines
  4. Usage examples
    1. Inserting a fresh callout
    2. Wrapping the current line
    3. Wrapping multiple lines
    4. Removing a callout
    5. Retaining custom titles
  5. Custom callouts (Callout Manager)
  6. Related plugins
  7. Feedback
  8. Appreciation

Commands provided

Two types of commands are provided: Wrap lines in X callout and Remove callout from selected lines. Using them together, you can easily change the type of an existing callout.

Tip

Both commands work on full lines of text, so your cursor position within a given line doesn't matter. As long as part of a line is selected, the entire line will be included.

Wrap lines in X callout

One Wrap lines in X callout command is provided for every possible callout type X (❞ Quote, ⚠ Warning, 🔥 Tip, 🐞 Bug, 📝 Note, etc.), so that you can assign separate hotkeys for each of your favorite callouts. This can be used both for inserting fresh callouts, and for turning existing text into callouts.

Remove callout from selected lines

Important

Note that a callout must begin on the first selected line of text for this command to be available.

This will remove the callout syntax from the selected lines, turning the callout back into regular text. If a custom title is present, it will be retained as a Markdown heading (see Retaining custom titles).

Usage examples

Inserting a fresh callout

To insert a fresh callout of your choice, simply run Wrap lines in X callout on a blank line:

Inserting a fresh callout

Wrapping the current line

If the current line is not blank and nothing is selected, the current line will be turned into a callout:

Wrapping the current line in a callout

Wrapping multiple lines

To turn multiple lines of text into a callout, first select the lines, and then run Wrap lines in X callout:

Wrapping multiple lines in a callout

Removing a callout

To turn a callout back into regular text, run Remove callout from selected lines with the given lines selected (make sure the callout header is on the first selected line):

Unwrapping a callout block

Retaining custom titles

If a callout has a default title (e.g. > [!quote] Quote), the entire header line will be removed when calling Remove callout from selected lines. If a custom title is present (e.g. > [!quote] Aristotle), it will be retained as a Markdown heading, so that you don't lose your hard work in choosing that title.

If you call Wrap lines in X callout on a selection whose first line is a Markdown heading, the heading will be used as the custom title for the new callout block:

Retaining custom titles

This makes it easy to switch between callout types while retaining your custom titles:

Retaining custom titles while switching between callout types

Custom callouts (Callout Manager)

This plugin automatically integrates with the Callout Manager plugin, if you have it installed. This means that the callout types available in this plugin will be automatically synced with your custom callout types in Callout Manager.

If you don't have Callout Manager installed, no worries—this plugin will still work as expected. A default set of callout types will be available for you to use.

Related plugins

As mentioned above, you can use Callout Manager (by eth-p) to customize how Obsidian handles callouts—e.g. adjust callout colors/icons, add your own custom callouts, etc.

If you'd like to be able to insert a fresh callout by choosing from a styled (with icons!) dropdown of callout types, you can also consider installing either/both:

  1. Personal Assistant (by edonyzpc): Shows dropdown when running command "List callout for quickly insert"
  2. Callout Suggestions (by cwfryer): Shows inline dropdown when typing >!

Feedback

If you have any feedback or suggestions, feel free to open an issue and I'd be happy to take a look when I can.

Appreciation

Thanks to the creators of Obsidian, seriously an awesome note-taking app! And big thanks to eth-p for providing a Callout Manager API—super cool.

About

An Obsidian plugin to quickly add, change, or remove callout wrappers in your notes.

Resources

License

Stars

Watchers

Forks

Packages

No packages published