Nested Tags Extension

View your notes without being limited by your file system's hierarchy. Transform Cursor/VS Code into a note-taking app by adding tag support.

Attribution: This extension is based on vscode-nested-tags by Blake Dietz, rewritten for compatibility with Cursor and modern VS Code versions.

Features

The extension scans markdown files in your workspace for tags and displays them in a hierarchical "Tag Tree" view in the Explorer sidebar.

Supported Tag Formats

HTML Comment Directive:

<!--@nested-tags:topic,here/is/a/nested/example-->

YAML Frontmatter (array style):

---
title: My Note
tags: [topic, here/is/a/nested/example]
---

YAML Frontmatter (list style):

---
title: My Note
tags:
  - topic
  - here/is/a/nested/example
---

Nested Tags

Use / to create nested tag hierarchies:

• project/frontend creates a "project" parent with "frontend" child
• work/meetings/2024 creates three levels of nesting

Usage

1. Add tags to your markdown files using any of the supported formats
2. Open the "Tag Tree" view in the Explorer sidebar
3. Click on any file to open it
4. Use the refresh button to manually rescan files

Installation

From VSIX

1. Download the .vsix file from releases
2. In Cursor/VS Code: Cmd+Shift+P → "Install from VSIX"
3. Select the downloaded file

Development

npm install
npm run compile

Press F5 to launch the extension in a new Extension Development Host window.

Package for Distribution

npx @vscode/vsce package

Credits

• Original extension: vscode-nested-tags by Blake Dietz
• Licensed under MIT

License

MIT License - See LICENSE for details.