An Obsidian plugin to quickly add, change, or remove callouts in your notes.
- Table of contents
- Commands provided
- Usage examples
- Available settings
- Callout Manager integration (custom callouts)
- Related plugins
- Feedback
- Appreciation
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.
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.
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.
To insert a fresh callout of your choice, simply run Wrap lines in X callout
on a blank line:
If the current line is not blank and nothing is selected, the current line will be turned into a callout:
To turn multiple lines of text into a callout, first select the lines, and then run Wrap lines in X 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):
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:
This makes it easy to switch between callout types while retaining your custom titles:
Whether inserted callouts should have an explicit (e.g., > [!quote] Quote
) or implicit (e.g., > [!quote]
) title by default.
The default capitalization format used for inserted callout IDs:
- Lowercase: E.g.
> [!my-custom-callout]
- Uppercase: E.g.
> [!MY-CUSTOM-CALLOUT]
- Sentence case: E.g.
> [!My-custom-callout]
- Title case: E.g.
> [!My-Custom-Callout]
Whether inserted callouts should be unfoldable, expanded, or collapsed by default.
Note
This setting only affects what Wrap lines in X callout
does when no text is selected. When text is already selected, the new callout's header is auto-selected for convenience, regardless of this setting.
Whether to auto-select text up until the cursor, after inserting a callout with no text selected—e.g. when inserting a fresh callout, or wrapping the current line.
Keep this setting disabled if you'd prefer to keep typing content after inserting/wrapping. Enable this setting if you'd prefer to be able to immediately run Remove callout from selected lines
instead (useful for switching between callout types):
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.
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:
- Personal Assistant (by edonyzpc): Shows dropdown when running command "List callout for quickly insert"
- Callout Suggestions (by cwfryer): Shows inline dropdown when typing
>!
If you have any feedback or suggestions, feel free to open an issue and I'd be happy to take a look!
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.