Folder Backlinks

An Obsidian plugin that lets you link to folders and see which notes reference each folder — the folder backlinks that core Obsidian doesn't have.

Features

• Link to folders from any note using regular wiki links: [[Projects/Work/]]. The trailing slash marks the link as a folder link so it never clashes with a note of the same name.
• Folder backlinks panel — a sidebar view listing every note that links to a folder. Click an entry to jump straight to the line containing the link.
• Insert commands — easily insert a folder link to the body of your note, or directly into an existing Property with a smart, fuzzy-search picker.
• Properties support — folder links automatically format themselves so they render cleanly in Obsidian's native Properties UI without exposing raw markdown brackets.
• Automatic renaming — if you rename or move a folder, the plugin automatically finds all your markdown files and updates any folder links pointing to it.
• Right-click a folder in the file explorer to copy a link to it or open its backlinks.
• Smart click handling — clicking a folder link reveals the folder in the file explorer, opens its backlinks panel, or both (configurable). Without this plugin, Obsidian would treat the link as unresolved and create a new note.
• Folder links are styled as resolved links in reading mode instead of looking broken.

Usage

1. Run Insert folder link to note or Insert folder link to property (command palette), or right-click a folder and choose Copy folder link.
2. Click any folder link, use the ribbon icon, or run Open backlinks for a folder to open the backlinks panel.
3. Configure click behavior and link format under Settings → Folder Backlinks.

Folder links use standard wiki-link syntax, so your notes stay plain Markdown and remain readable without the plugin.

Installation

From the community plugin browser (pending review)

Search for "Folder Backlinks" in Settings → Community plugins → Browse.

Manual

1. Download main.js, manifest.json, and styles.css from the latest release.
2. Copy them into <your vault>/.obsidian/plugins/folder-backlinks/.
3. Reload Obsidian and enable the plugin under Settings → Community plugins.

Building from source

npm install
npm run build   # produces main.js
npm run dev     # watch mode for development

Release provenance

Every release is built from this repository's source by GitHub Actions — no binaries are committed to the repo or uploaded by hand. Each release asset carries a build provenance attestation, which cryptographically ties it to the exact commit and workflow that produced it. You can verify any asset yourself:

gh attestation verify main.js --repo <owner>/<repo>

License

MIT