README file from
GithubFolder 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
- Run Insert folder link to note or Insert folder link to property (command palette), or right-click a folder and choose Copy folder link.
- Click any folder link, use the ribbon icon, or run Open backlinks for a folder to open the backlinks panel.
- 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
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Copy them into
<your vault>/.obsidian/plugins/folder-backlinks/. - 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>