All Collections
Linking Ideas
What's the difference between References, Tags, and Portals?
What's the difference between References, Tags, and Portals?

While References, Tags, and Portals all relate Rems, they have distinct purposes and behavior.

Soren Bjornstad avatar
Written by Soren Bjornstad
Updated over a week ago

References, Tags, and Portals are all ways of using the same content in multiple places and defining how things relate to each other. However, they have distinct functions.

Summary

Suppose you have two Rems, creatively called A and B, and you're editing A and want to refer to B.

Reference

Tag

Portal

In a few words

A link to another Rem

A note that A goes in category B

A window showing another Rem

Implies that

B is related to A

A is a type of B

B is used in the context of A

How to create it

Type [[ or @, then B

Type ##, then B

Type ((, then B

What it looks like

Everything it does

  • Shows a link to B within the text of A.

  • Creates a backlink from B to A.

  • Shows the name of B next to the Rem A.

  • Creates a backlink from B to A.

  • Gives access to the properties and templates defined by B, if they exist, to A.

  • Shows the full content of B right within A, updating all copies in real time if you make changes.

  • Creates a backlink from B to A.

Full docs

References

A Reference is simply a link to another Rem. The name of the Rem you reference appears in blue, and clicking on it takes you to the referenced Rem.

Use References when you want to mention some other related concept or piece of information, but don't think you'll need to immediately revisit its definition when rereading the notes later. If you think you will need the definition, you might prefer a Portal instead for greater convenience.

There's one additional trick to References: In RemNote, all links are bidirectional. That is, if you create a reference from Keyboard to Computer, you can not only see this link when looking at the Keyboard Rem, but also when looking at the Computer Rem. This backwards link (often called a backlink) appears under a References section which you can access by clicking the numbered bubble to the right of the Computer Rem.

The simplest way to create a Reference is to press [[ while typing; this will bring up an inline search box which you can use to find the Rem you want to reference.

Tags

Tagging one Rem with another means that the tagged Rem is a type of the tagging Rem. For instance, a Keyboard and a Mouse are both types of Hardware, so you might apply the Hardware tag to these two Rems.

As with References, tags are bidirectional; you can see all of the places a tag is used by clicking the numbered bubble on that tag's Rem.

The simplest way to add a tag to a Rem is to press ## while typing; this will bring up an inline search box which you can use to find the Rem you want to tag the current Rem with.

Portals

A Portal displays a particular Rem, and optionally some or all of its descendants, at an arbitrary place within some other notes. You can think of a portal like a window cut in the page with the source document placed behind it: you can see all the material at the other location right within the current document, but it's actually located in a different document, and if you update the information in one place, it will be updated in the original location as well as all its portals.

Use Portals when you want to keep information that is relevant in many contexts in one centralized place, but include it directly within your notes on particular sources or more specific topics for easy review.

You can tell that content is part of a portal when there is a blue bar at the left side of the content. When you click inside the portal, the bar extends into a full border around the entire portal.

Again, portals are bidirectional; the numbered bubble will show any places where the current Rem has been included in a portal (unless the portal is within the current document).

The simplest way to add a portal is to press (( while typing; this will bring up an inline search box which you can use to find the Rem you want to tag the current Rem with.

In other notes systems, features similar to portals may be called transclusions or mirrors.

Did this answer your question?