Skip to main content

Powerups

Powerups give an individual bullet extra behavior, like highlighting, todos, or Extra Card Detail.

Written by Soren Bjornstad

Most of what a bullet can do beyond holding text comes from a powerup. Highlighting a bullet, turning one into a todo, making one a header, marking something as Extra Card Detail: each of these applies a powerup, a small piece of behavior attached to a single bullet.

Some powerups change a bullet's appearance the moment you apply them, and you won't see anything else to tell you they're there. Todos work this way: the large checkbox on the left side of the bullet makes it obvious what the bullet is, so nothing further is needed. Other powerups do nothing noticeable until later. Extra Card Detail, for instance, only matters while you're practicing flashcards, so a small label with it's name appears in the bullet's right margin to remind you it's applied.

A flashcard bullet with two child bullets, each marked by an Extra Card Detail pill on the right side, with an arrow pointing at the pills.

Applying and removing powerups

You can find most powerups on the /-menu. (A few internal powerups that you'd have no good reason to attach to a bullet yourself are left off the /-menu.) For example, use /red to highlight a bullet in red, or /ecd to make a bullet appear as Extra Card Detail.

If a bullet already has a powerup and you want to remove it, you can do so in several ways, depending on the kind of powerup:

  • If the powerup shows a label in the right margin, click the X button on that label.

  • If the powerup is an on-or-off state, activate it again (for example, type /ecd a second time to turn off Extra Card Detail).

  • If the powerup is one of a group of values, select the "off" or "none" item in that group from the /-menu (for example, type /no highlight after typing /red or another color to remove the highlight powerup).

Powerups from plugins

The powerups described above are the ones built into RemNote. Plugins can define powerups of their own, and those work a little differently: a plugin's powerup is implemented as a tag.

This is worth knowing, because tags can do things built-in powerups can't. A powerup applied by a plugin appears in the ## tag search like any other tag, and you can gather the bullets carrying it into a table to see the data the plugin has stored on them side by side.

Searching for bullets with a powerup

To find every bullet carrying a particular powerup, use a search portal. Insert one with /isp, open the visual query builder, and choose Has Powerup, then pick the powerup you want. To collect all the todos in a particular document, for instance, combine In Document, set to that document, with Has Powerup, set to Todo.

A search portal over a daily document's todos, with the visual query builder open showing Has Powerup set to Todo combined with In Document.

Not every powerup appears in the Has Powerup list. It offers the ones most likely to be useful to collect in a portal, including Todo, Document, Daily Document, Edit Later, Tags, Calendar, and Restored from Trash. Highlights, headers, and Extra Card Detail are powerups too, but they aren't offered in this list.

Slots

For many powerups, applying the powerup to a bullet also stores one or more hidden data fields, called slots, on that bullet. Selecting any highlight color applies a single Highlight powerup with a different value in its Color slot, and the Todo powerup has Unfinished and Finished values, which record whether you've checked the todo off.

Powerup slots are fundamentally the same idea as properties in templates. The difference is that slots are built into RemNote rather than defined by you, and they look different in the editor.

Searching by slot value

Just as you can search for every bullet carrying a powerup, you can narrow a search to bullets with a particular value in one of that powerup's slots. In the query builder, choose Has Powerup With Slot Value rather than Has Powerup, then pick the powerup, the slot, and the value you're looking for.

To extend the example above, suppose you don't want every todo in the document, only the ones you haven't finished yet. Choose Has Powerup With Slot Value, select the Todo powerup, and set the status to Unfinished.

The query builder using Has Powerup With Slot Value with the Todo powerup and status Unfinished, returning only the three unfinished todos.

Two powerups can be searched this way. The Todo powerup has a status of Finished or Unfinished, and the Document powerup has a status of Pinned. Other powerups still have slots, and the values below are worth knowing when you're reading your notes, but they aren't available in the query builder.

If you'd rather write queries by hand than use the builder, Searching with the RemNote Query Language gives the syntax for both of these searches.

A few common slot values

  • Todo: Finished, Unfinished

  • Highlight: Red, Orange, Yellow, Green, Blue, Purple

  • Header: H1, H2, H3

Did this answer your question?