Obsidian Stats logoObsidian Stats

Inline Tag

by mb-yul
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Reference tags with readable labels that open native tag search on click.

Reviews

No reviews yet.

Stats

stars
119
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Inline Tag — Obsidian Plugin

Write tag references with display labels. Click to search.

GitHub release Obsidian Downloads License: MIT

Support

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

Buy Me A Coffee Ko-fi

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.

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

Reading view with search results 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

Sponsors