Tags

Tags are keywords or topics that help you quickly find the notes you want.

Add a tag to a note

To create a tag, enter a hash symbol (#) in the editor, followed by a keyword. For example, #meeting.

You can also add tags using the tags property. Tags in YAML should always be formatted as a list:

---
tags:
  - recipe
  - cooking
---

Find notes using tags

To find notes using the Search plugin, use the tag search operator in your search term, for example tag:#meeting.

You can also search for tags by clicking on them in your notes.

To find notes using the Tags view plugin, select Tags: Show tags in the Command palette, and then select the tag you want to search for.

Nested tags

Nested tags define tag hierarchies that make it easier to find and filter related tags.

Create nested tags by using forward slashes (/) in the tag name, for example #inbox/to-read and #inbox/processing.

  • In Search, tag:inbox will match #inbox as well as all nested tags such as #inbox/to-read.
  • In the Tags view, nested tags are shown as belonging to their parent tag.
  • In Bases, nested tags are recognized by the `hasTag` function, so file.hasTag("a") will match both #a and #a/b.

Tag format

You can use any of the following characters in your tags:

  • Alphabetical letters
  • Numbers
  • Underscore (_)
  • Hyphen (-)
  • Forward slash (/) for Nested tags

Tags must contain at least one non-numerical character. For example, #1984 isn't a valid tag, but #y1984 is.

Tags are case-insensitive. For example, #tag and #TAG will be treated as identical.

Note

Tags will display with the casing they are first created with in the Tags view.
For example, creating #Tag and then #TAG will display #Tag for both.

Tags can't contain blank spaces. To separate two or more words, you can instead use the following formats: