Tags

OnyxFolio collects tags from two sources per note: the tags: frontmatter list and inline #hashtag mentions in the note body. Both are merged into a single tag set.

Frontmatter tags

tags:
  - python
  - philosophy
  - open-source

Tags are lowercased and normalised at load time.

Inline hashtags

Any #word in the note body that starts with a letter is collected as a tag:

This post is about #python and #obsidian workflows.

These are merged with frontmatter tags — no duplicates.

Pattern: #([A-Za-z][A-Za-z0-9_-]*) — must start with a letter, may contain letters, numbers, hyphens, and underscores.

Tag display

On post pages, tags render as clickable badge links. Clicking a tag navigates to its archive page.

Tag archive pages

Each tag has its own archive page at /tag/<name>:

/tag/python       — all posts tagged "python"
/tag/philosophy   — all posts tagged "philosophy"

Archive pages show posts sorted by date (newest first) with prev/next navigation within the tag.

Tag index

Enable the /tags page by adding show_tags: true to the root homepage's frontmatter:

show_tags: true

This adds a Tags link to the top navigation. The tags index at /tags lists every tag with its post count, sorted alphabetically.

Search filter

The search page at /search includes a tag filter dropdown. Users can narrow results to a specific tag while also entering a text query.

Dataview filtering

Use tags in FROM and WHERE clauses to query notes by tag:

```dataview
TABLE date, summary
FROM #onyxfolio
SORT date DESC
LIMIT 3
```

```dataview
LIST
FROM #documentation
SORT date DESC
LIMIT 5
```

Tags on private notes

Tags are collected from all vault notes during Pass 1, including notes without website: true. This means private notes contribute to Dataview tag queries even though they don't appear on the public site.

See also

• [[Search]] — text search with tag filter
• [[Dataview]] — FROM #tag and contains(tags, ...) queries
• [[Frontmatter Reference]] — show_tags and tags fields