#
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
.
Both the Search and Tags view plugins support nested tags.
#
Tag format
You can use any of the following characters in your tags:
- Alphabetical letters
- Numbers
- Underscore (
_
) - Hyphen (
-
) - Forward slash (
/
) forNested 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:
- #camelCase
- #PascalCase
- #snake_case
- #kebab-case