Inline Tag — Obsidian Plugin

Write tag references with display labels. Click to search.

---

Support

If this plugin saves you time, a coffee is always appreciated ☕

---

What it does

Obsidian tags are powerful, but there's no built-in way to reference a tag inline with a human-readable label. This plugin introduces a simple syntax that bridges tags and wikilinks:

[[#tag-name|Display Label]]

In Reading view, this renders as a clickable label. Clicking it opens Obsidian Search pre-loaded with tag:#tag-name, showing every note associated with that tag — including notes that reference it via this syntax.

Write [[#tag|Label]] anywhere in your note — #tag is the searchable target, Label is what gets displayed.

Tags render as clickable labels. Clicking one searches across all notes that share it — here returning 5 results across two notes.

---

Syntax

[[#TAG|LABEL]]

Part	Rules
TAG	Required. No spaces. Letters, digits, -, _, /, Unicode.
LABEL	Required. Spaces and Unicode allowed.

Valid

[[#backend|Backend]]
[[#work/dev|Web Development]]
[[#ui-ux|UI/UX]]
[[#project-alpha|Project Alpha]]

Invalid (left as raw text)

[[#tag with spaces|Label]]   ← space in tag
[[#tag]]                     ← missing label
[[tag|Label]]                ← missing leading #
[[#|Label]]                  ← empty tag
[[#tag|]]                    ← empty label

---

Installation

From Obsidian Community Plugins (recommended)

1. Open Settings → Community plugins
2. Disable Safe mode if prompted
3. Click Browse and search for Inline Tag
4. Install and enable

Manual

1. Download the latest release from GitHub Releases
2. Copy main.js, manifest.json, and styles.css into your vault's .obsidian/plugins/inline-tag/ folder
3. Enable the plugin in Settings → Community plugins

---

Settings

Setting	Default	Description
Live Preview decorations	On	Render tokens as styled labels in Live Preview; the cursor reveals raw syntax inside a token. Desktop only — not available on mobile.
Show canonical tag on hover	On	Tooltip shows tag:#name on hover
Style mode	Link	Link = styled like a wikilink · Tag pill = styled like a native tag
Debug logging	Off	Logs to DevTools console (Ctrl+Shift+I)

---

How search works

Clicking a rendered label opens Obsidian Search with:

(tag:#tag-name OR "[[#tag-name|")

This finds:

• Notes with a native #tag-name Obsidian tag
• Notes that reference the tag using this plugin's syntax

Both usages are discoverable from a single click.

---

Inserting tags

Autocomplete while typing

Start a token with [[# and type a few characters — a suggestion list filtered from your vault's existing tags appears immediately. Select one to insert [[#tagname| with the cursor ready for the label.

Wrap selected text

Select any text, right-click, and choose Wrap as inline tag. A fuzzy-search modal lets you pick the tag; the selection becomes the label.

---

Known limitations

• Live Preview not available on mobile. Obsidian for Android and iOS does not use the CodeMirror 6 editor extension system, so the Live Preview decoration engine cannot run there. Tokens will render correctly in Reading view on all platforms.
• No hover preview of matching notes.
• No tag rename / refactor tooling.

---

Contributing

Issues and PRs are welcome on GitHub.

To build locally:

git clone https://github.com/MB-YUL/obsidian-inline-tag-plugin

cd obsidian-inline-tag-plugin
npm install
npm run dev      # watch mode
npm run build    # production build

Copy the output (main.js, manifest.json, styles.css) into your vault's plugin folder.

---

License

MIT © MB-YUL