Inline Tags and Note Reference Filtering

linkTable of Contents

linkWhat are Note References?

Note References are simply links to other notes. It's highly likely you've been using them for a while now!

Here are some of the ways in which you can create a reference to another note:

Using the double-bracket linking syntax: [[:

More info over at Using Double Brackets [[ for Note Creation/Linking#Simple double bracket note linking examples.

Using the Ctrl-[ hotkey to turn the selected text into a link to a note:

About the note linking hotkeys: Using Double Brackets [[ for Note Creation/Linking#Using the Ctrl-[ hotkey to link a selected word/phrase (optionally including the current note's tags).

linkWhat are Inline Tags?

We have good news: Inline Tags are just Note References! You can lie back and relax, knowing that you don't need to learn about another new note-taking concept today 😌.

We prefer the term "Note References"' to avoid the conflict of nomenclature ("tags" is what we call our much older feature, tags 🙂). That said, throughout the rest of this documentation, we will use "Note References" and "Inline Tags" interchangeably.

Traditional Tags haven't changed and they are still only applied at the level of a note. In order to tag only part of a note with something, you can now use Note References. For example, labeling one of your tasks as "low effort" might look something like the following:

Refund concert tickets (@low-effort)

linkHow do I create an Inline Tag?

To create an Inline Tag inside a task, simply create a link to the respective note. Check out the official help page on creating links in Amplenote (Using Double Brackets [[ for Note Creation/Linking), or read below for some quick examples:

linkAdding an existing Inline Tag to a task

Inline Tags are just links to notes. Using the double-bracket [[ syntax, you can add an existing Inline Tag by using the linking menu to search for the appropriate note:


linkCreating a new inline tag and adding it to a task

When the note linking menu cannot find the note you are searching for, it gives you the option of creating a new one. Use this to simultaneously create a tag and add it to your task:

Note: in this recording we also use the tilde ~ sign at the beginning of the link. This prevents the journal tag from being automatically applied to the newly created note. Read more here: Control auto-tagging of newly linked notes.

linkWhy do Note References work as Inline Tags?

To best explain why this mechanism works, it might be best to look at the two main things that Traditional and Inline Tags have in common:

A mechanism to effortlessly apply existing tags (e.g. via suggestions & auto-completion);

Traditional Tags (left) and Inline Tags (right)

A way to filter your notes/tasks by using combinations of tags;

Traditional Tags (left) and Inline Tags (right)

linkHow to filter to-dos by Note References?

The first application of inline tags is for filtering your tasks. This is possible both In Tasks Mode and In Calendar Mode.

linkIn Tasks Mode

In Tasks Mode, you can now filter your to-dos by the notes they reference (in addition to filtering by the tag of the source note!). The Reference Filtering menu sits above the formatting bar.

Use the new Filter Tasks by Note Reference button to start narrowing down your list of to-dos.

Click to add a new note to filter on

Adding more than one note will only show tasks that reference both notes

Shift-Click on a note to remove tasks that reference that note

linkSaving a set of Task Mode Note Reference filters

Once you've chosen the Note Reference filters you want to apply, you can save the filter set by tapping the "Star" icon next to the selected task tag title:

As with any Shortcut, you can set it as the Default Shortcut by clicking the arrow in the left side nav if you want to open this set of reference filters when you initially enter Tasks mode.

linkIn Calendar Mode

Use the filter icon to open the Note Reference Filter menu. Just like In Tasks Mode:

Click to add a new note to filter on

Adding more than one note will only show tasks that reference both notes

Shift-Click on a note to remove tasks that reference that note

💡 Note how in Calendar Mode:

The list of notes to filter on is not determined by the current Task Domain;

The list of notes that tasks are taken from is still limited to those added to the current Domain.

linkSaving a set of Calendar Mode Reference filters

Once you have chosen a set of Note References chosen to include or exclude, you can save them by clicking the star next to the set of filters:

This makes it easy to return to this set of Note Filters if it is one that you will engage with regularly.

linkAdvanced filtering

linkTasks Mode: Filtering by Tags and Note References

You might notice that applying a Reference filter will only display tasks from the currently selected tag. This means that you can combine Traditional and Inline Tags in your filters to get as specific as you need.

One example where this specificity is needed is for separating work tasks from personal tasks. If you want to view your "@next" tasks, but you're only interested in work-related tasks, you simply have to:

Apply the work tag filter;

Apply the "@next" Reference filter ✨.

💡 Useful filtering tips:

If you're browsing a specific list of tasks more often, make sure to use a Tag Shortcut to make that list more accessible: Organizing with tags#Tag Shortcuts, and the Default Shortcut (Reference-based shortcuts are coming soon);

When in Tasks Mode, click on the "Tasks" button again to clear any active tag filters;

Multi-tag selection works in combination with Reference filters! Check out the help page: Organizing with tags#Multi-tag selection.

linkExcluding Note References

In both Tasks and Calendar Modes, Shift-Click on a note title to exclude tasks that are tagged with that note:

linkHow to filter arbitrary blocks by Note References?

Support for advanced block filtering is coming soon 🚀.

In the meantime, you can use the existing backlinking functionality to apply simple, one-note filters (Backlinking (bidirectional linking) examples, filtering backlinks, targeting backlink content) and combine that with tag-based filtering (Backlinking (bidirectional linking) examples, filtering backlinks, targeting backlink content#Filtering Backlinks).

linkHow is this useful?

While Traditional Tags continue to be very powerful in Amplenote, below are the most popular use cases for Inline Tags that we have seen our users implement.

linkSetting up Task Contexts

Decorating your tasks with other relevant metadata can be useful to narrow down what needs to be done next. If you've heard about David Allen's Getting Things Done or GTD, you might already be familiar with this concept.

The core issue that stands to be resolved is that with time, your tasks will accumulate and your to-do list will become unmanageably large. How are we supposed to know what to start working on?

The proposed solution is to periodically process the tasks that make their way into your notebook. While processing these tasks, it proves very useful to tag them in a way that signals what kind of action they represent and what is necessary in order to complete them.

The most common candidates for "Contexts" are people, places and objects that are required in order to complete a task. For example, one could add the tag @Office to all tasks that can only be done while at the office. Or one could add the tag @Phone-call to all the tasks that require talking with somebody on the phone in order to complete.

Then, when a reasonably consistent tagging habit is in order, it's effortless to filter your tasks (In Tasks Mode or In Calendar Mode) based on what kind of context you find yourself in at any given moment.

Here is a non-exhaustive list of tags that we've found productive:

One idea to take home is that the main purpose of using Contexts is to avoid overwhelm. Zooming in on a single context allows you to only see what is currently actionable and avoid information overload. Use Contexts sparingly, in a way that is helpful and easy to remember. Doing this will ensure that you don't introduce more friction where you're trying to eliminate it in the first place 🙌.

linkLinking and categorizing ideas

Inline Tags don't just apply to tasks! You can reference notes in any arbitrary type of block, such as ordinary paragraphs, bullet points or headings.

If you've been using Amplenote's backlinks for a while, you know that you can browse all of the incoming links of a note using the Backlinks tab found at the bottom of that note. Also, you've probably noticed that in addition to displaying the link itself, Amplenote also shows you the surrounding context of that link.

When you reference a note in a block, everything "underneath" that block is effectively tagged with that Note Reference a.k.a. Inline Tag. Make sure to read up on Backlinking (bidirectional linking) examples, filtering backlinks, targeting backlink content#What will get shown in the Backlinks tab? for more details on this, but to cut a long story short:

Tagging a bullet or a task also tags all of its sub-bullets/sub-tasks;

Tagging a heading also tags all of the blocks contained in that heading or in headings of lower order.

If you're a Jots user, you might already intuit how to apply this functionality: with Inline Tagging you can carry out almost all of your note-taking and task-creating straight from your Daily Jot.

Let's take the example of meeting notes. One way to capture relevant info pertaining to work meetings is to create a separate note and title it accordingly:

The other way to achieve this would be to write the meeting notes directly inside your Jot:

Notice how we tag the bullet point with both Planning meeting and @Richard. Instead of creating a note for each planning meeting, we're creating two notes that we can reuse whenever they are implied by the context.

Now, when visiting the backlinks tab for the note called "Planning meeting", we can see when this meeting happened, who it happened with, and any notes we've taken in the sub-bullet points:

When Reference filtering is implemented for Notes Mode, you will be able to use the Backlinks tab of a note to perform advanced backlink filtering. For example, you will be able to look up all "planning meetings" that took place with multiple people simply by selecting the relevant Reference filters.

linkTraditional vs Inline Tags?

Below are some guidelines for choosing between Tags and Note References. Keep in mind that this is not a hard rule-set and that we think you should be experimenting to find the system that makes most sense to you 🙌.

Choose Traditional Tags for:

Delimiting the domain of applicability for notes (e.g. #blog for notes pertaining to blog posts, #todos for notes containing actionable items);

Choose Inline Tags for:

Tagging individual tasks to surface useful categories (e.g. "Next" for items that need to be done to advance a project, "On hold" for tasks that can be safely filtered away);

Separating to-dos into projects (e.g. [ ] This is a task that pertains to [[This personal Project I'm doing]]

Whenever you're logging date-sensitive information (e.g. tagging a section of your Jot with "Meeting note" instead of creating a note called "Meeting note <today's date>"; see Linking and categorizing ideas);

Registering references to subjects of interests, such as people, music, movies or concepts you are interacting with on a regular basis.

As a rather general and incomplete rule: Traditional tags should be general, Inline Tags should be specific. One of the best examples to illustrate this is the following: use Inline Tags for every person with whom you interact meaningfully (e.g. specific people's names such as "@Wayne" or "@Beatrice"), and use a Traditional Tag to group these together (e.g. #people).