---
title: Wikilinks & Tags
description: Connect your notes with links and organize them with tags
---

Wikilinks and tags are how you connect your notes. Wikilinks create direct links between notes. Tags let you categorize and filter across your entire workspace.

## Wikilinks

A wikilink is a reference to another note, written in double brackets:

```
[[Note Name]]
```

Tap a wikilink in the editor to jump to that note. If the linked note doesn't exist yet, tapping it creates it.

### Linking to Notes in Subfolders

If a note lives inside a folder, include the path relative to the workspace root:

```
[[Projects/Design Doc]]
[[Work/Meetings/Standup Notes]]
```

The `.md` extension is optional — Octarine adds it automatically.

### The Suggestion Popover

Tap the **[[** button in the toolbar (or type `[[` manually) to trigger the suggestion popover. As you type inside the brackets, the popover filters your notes in real time using fuzzy matching. Tap a suggestion to complete the link.

## Tags

A tag is any word prefixed with `#` in the body of a note:

```
Working on the new dashboard. #project #frontend
```

Tags are extracted and indexed automatically. They support letters, numbers, underscores, hyphens, and Unicode characters.

### Nested Tags

Use `/` to create a tag hierarchy:

```
#work/engineering/backend
#priority/high
```

Nested tags let you organize categories at multiple levels. A note tagged `#work/engineering` will also appear under the parent `#work` when browsing.

### Tag Suggestions

When you type `#` in the editor, a suggestion popover appears with existing tags from your workspace. This makes it easy to reuse tags consistently without remembering the exact spelling.

## Browsing Tags

Open the **Tags** page from the More menu. It displays all tags in your workspace as an indented hierarchy with a note count for each one.

- **Search** — filter tags by typing in the search field at the top.
- **View notes** — tap a tag to see notes using that tag or any child in its namespace.
- **Switch tags** — tap the selected tag in the results header to jump to a different tag without returning to the full index.
- **Search results** — use the header search button to filter notes inside the selected tag.

If no tags exist yet, the page shows a "No tags found" message.

## Backlinks

When note A links to note B via a wikilink, note B records that as a backlink. Open the note, tap the info button in the editor header, and choose **Backlinks**.

Backlinks let you discover connections you might not remember — which notes reference the one you're reading.
