Advanced Metadata Cache

by Michael Naumov
5
4
3
2
1
Score: 53/100

Description

Category: Coding & Technical Tools

The Advanced Metadata Cache plugin maintains optional indexes for backlinks, note names, frontmatter titles and heading history to avoid repeated full vault scans. Its Backlinks module replaces the core lookup while retaining fast, safe and original calls for compatibility. The Names module accelerates link suggestions and supports reverse lookup by note name or alias. Titles can expose configured frontmatter properties as names and optionally append them to wikilink autocomplete. Canvas links are indexed, with frontmatter markdown links supported when the related plugin is installed. The Headings module records created, modified and seen times without changing note content, then exposes them through a published API. Each module can be enabled independently, unloads its listeners and commands when disabled and rebuilds its index when switched on.

Reviews

No reviews yet.

Stats

4
stars
4,393
downloads
0
forks
49
days
2
days
2
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
2
total issues
0
open issues
2
closed issues
283
commits

Latest Version

3 days ago

Changelog

  • docs: re #4
  • build(demo-vault): type-check the setup scripts

Full Changelog: https://github.com/mnaoumov/obsidian-advanced-metadata-cache/compare/2.7.0...2.7.1

README file from

Github

Advanced Metadata Cache

Buy Me a Coffee GitHub release GitHub downloads Coverage: 100%

Some of the questions Obsidian answers about a vault have no index behind them. Asking which notes link to this one means scanning every note, on every call — the Backlinks pane pays that cost, and so does every plugin that asks the same question. Asking what every note is called means the same walk, and the [[ autocomplete pays it every single time you open it. On a large vault it is slow enough to be felt.

This plugin maintains the indexes those questions deserve and answers from them instead. It does so by replacing the method that already asks the question, so nothing has to know the plugin is installed: the Backlinks pane gets faster, and so does anything else that asks.

Each index is a module that is switched on or off on its own, so a vault only pays for the ones it uses. On a small vault you will not notice any of them; that is the point at which you do not need this.

Demo vault

The documentation is an interactive demo vault. Every feature has a note that explains what it does and why you would want it, with buttons that measure the difference for real.

Start reading here — it is plain markdown, so it works on GitHub with nothing installed.

A copy of the vault ships with every release. You can access it via any of the following:

  1. Running the Advanced Metadata Cache: Open demo vault command, on desktop. The command is not available on mobile, so use the next option there.
  2. Downloading advanced-metadata-cache-demo-vault.zip from the Releases. It unzips into a single advanced-metadata-cache-demo-vault-<version> folder.
  3. Browsing its source in demo-vault/ in this repository.

What it does

  • A backlink index that keeps itself current, so the Backlinks pane and every plugin that asks for backlinks stop rescanning the vault. 01 Backlink cache
  • Three ways to ask — fast from the cache, safe after pending changes settle, or the original built-in implementation for comparison — and one more Obsidian has no call for: which notes link to a note that does not exist yet. 02 Fast, safe, and original backlinks
  • Canvas files are indexed too, and so are frontmatter markdown links when Frontmatter Markdown Links is installed. 03 Canvas backlinks
  • A name index behind the [[ autocomplete, so opening it stops rescanning every note in the vault for its name and aliases. 05 Name index
  • A frontmatter property can name a note too, found under its title, Quick switcher included, and, if you ask, offered under it by the [[ autocomplete. Name patterns build a person's other names from lastName and firstName, once per language, so none has to be stored as an alias. 06 Titles
  • When each heading was created, modified and seen, recorded per heading without touching the note, so other plugins can sort a note's headings by time. 07 Heading times
  • Notes by frontmatter property value, dates kept in order, for other plugins to ask without scanning the vault, answered from disk at startup. 08 Property index
  • Unlinked mentions without reading every note, so the Backlinks pane's Unlinked mentions section reads only the notes that mention the note, and lists exactly what it listed before. 09 Unlinked mentions
  • A file answers to the texts links show for it, so [alpha](bravo.md) lets other plugins find bravo.md as alpha, and ![[scan-0042.pdf|March invoice]] lets them find an attachment as March invoice. 10 Link texts
  • Links inside code blocks that are really notes, such as an ad-note admonition, count like any other link once you list the block's language: in backlinks, outgoing links, the graph and rename updates. 11 Code block links
  • Which notes carry a tag, in their text or in their tags property, so other plugins find the notes tagged #project, nested tags included, without reading every note's cache. 12 Tags
  • Which notes link to a website, so other plugins can show a site's backlinks, suggest URLs the vault already uses and flag a host that looks like a typo, from every http or https link, bare, in a markdown link or in a property. 13 External links
  • Shared HTML source ranges and sanitizer checks let other plugins inspect markup without repeatedly parsing the vault. 15 HTML
  • Properties for one heading or block, written in an advanced-metadata-cache code block right under it, the way frontmatter is written for the note, so other plugins can read them and find every block marked status: open across the vault. 16 Block metadata
  • Metadata from other file types, such as Markdown links in .mdx or .fountain, reaches core backlinks, graph link resolution and Bases property reads; plugins can register their own parsers. 14 Non-Markdown
  • Every index is a module of its own, switched on or off without touching the others; Backlinks, Properties, Link texts, Code block links and Non-Markdown are on by default. The last two read nothing until configured or registered by a plugin. A module switched off unloads completely. 04 Settings

Derived caches stay on each device; heading history and registered property names sync through ordinary vault files. See Storage and sync.

See also

My other Obsidian resources

Plugin Features How Advanced Metadata Cache differs
Backlink Cache (my plugin) Retired; points to its successor, which now carries the backlink index Supersedes Backlink Cache: includes its backlink index; adds: names, titles, headings, properties, unlinked mentions
Boost Link Suggestions Alternative wikilink suggester; link-count and manual-boost ordering Same suggestion goal; keeps core suggester/order; indexed lookup instead of vault walks
Datacore Reactive indexed query engine; JavaScript and JSX views Different integration: accelerates core calls and their consumers; no query language
Dataview Page/inline-field indexes; query language and JavaScript tables/lists/tasks Different integration: core calls and startup-loaded property lookups; no query language
Front Matter Title Frontmatter titles in explorer, tabs and graph Complementary title lookup: finds notes by title; offers titles in autocomplete; no display changes
Vault Map JSON Lines export of frontmatter, links, embeds and backlinks Alternative index access: in-memory core calls and plugin API; no export file

Last searched for similar plugins on 2026-10-26.

For plugin developers

This plugin makes two core calls faster for every plugin that makes them, and publishes an API, declared in api.d.ts, for what core has no call for. The member-by-member reference is docs/api.md.

app.metadataCache.getBacklinksForFile(file) (the Backlinks module) and app.metadataCache.getLinkSuggestions() (the Names module) keep Obsidian's own signature and answer what Obsidian would, so there is nothing to do to use them.

Everything else (the safe, original and reverse-lookup variants of those two calls, titles, heading times, notes by property value or date, unlinked mentions, link texts, notes by tag, external links, HTML candidates and diagnostics, and the code block languages whose links count) is AdvancedMetadataCacheApi:

import { watchPluginApi } from '@mnaoumov/obsidian-lib/plugin/plugin-api';

import type { AdvancedMetadataCacheApi } from './api.d.ts';

import { ADVANCED_METADATA_CACHE_API_CONTRACT } from './api-contract.ts';

const apiRef = watchPluginApi<AdvancedMetadataCacheApi>({
  apiVersionRange: '^1.3',
  app: this.app,
  component: this,
  contract: ADVANCED_METADATA_CACHE_API_CONTRACT,
  pluginId: 'advanced-metadata-cache'
});

// `value` is always current and never stale: `null` while this plugin is not loaded, and non-`null`
// on its own once it is.
const api = apiRef.value;
if (api) {
  console.log(api.getTitles('Notes/Some note.md')); // ['The Real Name']
}

The handle comes from the @mnaoumov/obsidian-lib plugin registry; Cross-plugin APIs covers watchPluginApi and the registry from the library's side. The contract version moves independently of the plugin's own, so ask for a range, and ask for the lowest version that has every member you call; the reference says which version each one arrived in.

If you would rather not depend on @mnaoumov/obsidian-lib for the handle, the registry is a documented wire protocol you can read directly — see Plugin API protocol.

Installation

The plugin is available in the official Community Plugins repository.

Beta versions

To install the latest beta release of this plugin (regardless if it is available in the official Community Plugins repository or not), follow these steps:

  1. Ensure you have the BRAT plugin installed and enabled.
  2. Click Install via BRAT.
  3. An Obsidian pop-up window should appear. In the window, click the Add plugin button once and wait a few seconds for the plugin to install.

Debugging

By default, debug messages for this plugin (id: advanced-metadata-cache) are hidden.

If you need to enable them refer to the documentation.

Changelog

All notable changes to this project will be documented in the CHANGELOG.

Contributing

Contributions are welcome — see CONTRIBUTING to get set up.

Support

Filing an issue (for AI agents and humans)

Open issues through the issue forms, not as blank issues.

To report a bug from inside Obsidian, run the Advanced Metadata Cache: Report a bug command. It opens the bug form with the plugin version, the Obsidian version and your operating system already filled in.

Filing from the CLI or the API (gh issue create --body, or an AI agent filing for you) skips the form, and gh issue create --template cannot load an issue form. In that case, open the matching form in .github/ISSUE_TEMPLATE/, copy every field as a ### <label> heading in the form's order, and fill in each one. Always state the plugin version, the Obsidian version and your operating system.

License

© Michael Naumov

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Dataview
6 years ago by Michael Brenan
A data index and query language over Markdown files, for https://obsidian.md/.
Recent Files
6 years ago by Tony Grosinger
Display a list of most recently opened files
PDF++
6 months ago by ryotaushio
PDF++: the most Obsidian-native PDF annotation & viewing tool ever. Comes with optional Vim keybindings.
Meta Bind Plugin
4 years ago by Moritz Jung
A plugin for Obsidian to make your notes interactive with inline input fields, metadata displays, and buttons.
Better Export PDF
5 months ago by l1xnan
Obsidian PDF export enhancement plugin
Pretty Properties
a year ago by Anareaty
Metadata Menu
4 years ago by mdelobelle
For data management enthusiasts : type and manage the metadata of your notes.
Custom File Explorer sorting
4 years ago by SebastianMC
Take full control over the order and sorting of folders and notes in File Explorer in Obsidian
Supercharged Links
6 years ago by mdelobelle
obsidian plugin to add attributes and context menu options to internal links
MetaEdit
5 years ago by Christian B. B. Houmann
MetaEdit for Obsidian
Digital Garden
4 months ago by oleeskild
Front Matter Title
4 years ago by Snezhig
Plugin for Obsidian.md
Media DB Plugin
4 years ago by Moritz Jung
A plugin that can query multiple APIs for movies, series, anime, games, music and wiki articles, and import them into your vault.
Snipd Official
6 months ago by snipd-app
Auto Card Link
5 years ago by Nekoshita Yuki
Force note view mode
5 years ago by Benny Wydooghe
Update time on edit
5 years ago by beaussan
April Automatic Timelines
5 months ago by april-gras
Simple timeline generator plugin for story tellers using obsidian
Update frontmatter modified date
3 years ago by Alan Grainger
Automatically update a frontmatter/YAML modified date field
Life Tracker
6 months ago by Sébastien Dubois
Capture and visualize the data that matters in your life
Featured Image
2 years ago by Johan Sanneblad
Obsidian plugin to automatically set a featured image property in your notes based on the first image, YouTube link, or Auto Card Link image found in your document. This allows you to create rich note galleries using Folder Notes and Dataview.
Backlink Cache
3 years ago by mnaoumov
Retired. Use Advanced Metadata Cache, which carries this backlink cache.
Influx
4 years ago by Jens M Gleditsch
An alternative backlinks plugin, which displays relevant and formatted excerpts from notes with linked mentions, based on the position of mentions in the notes' hierarchical structure (bullet level indentation).
Base Board
6 months ago by mderazon
Kanban Plugin For Obsidian
Frontmatter Tag Sugest
5 years ago by Jonathan Miller
Autocompletes tags in Obsidian YAML frontmatter. No more deleting #!
Metadata Extractor
5 years ago by kometenstaub
Obsidian Plugin that provides metadata export for use with third-party apps.
Daily Note Outline
4 years ago by iiz
Add a custom view which shows outline of multiple daily notes with headings, links, tags and list items
Auto Keyword Linker
10 months ago by Daniel Rhodes
Stop manually typing [[brackets]] around recurring terms. Configure keywords with variations once, and automatically link them as you write or across your entire vault.
Simple Banner
a year ago by Sandro Ducceschi
Visually enhance your Obsidian notes with a customizable banner. Supports icons and time/date display.
Project Browser
3 years ago by Dale de Silva
Frontmatter Markdown Links
2 years ago by mnaoumov
Obsidian Plugin that adds support for markdown links in frontmatter
AutoMOC
5 years ago by Diego Alcantara
AI Tagger Universe
2 years ago by Hu Nie
An intelligent Obsidian plugin that leverages AI to automatically analyze note content and suggest relevant tags, supporting both local and cloud-based LLM services.
Front Matter Timestamps
2 years ago by LighthouseDino
Track note created and modified times in front matter, kept up to date automatically.
Fold Properties By Default
2 years ago by Tommy Bergeron
Always have editor/metadata properties folded by default.
Current View
a year ago by Lucas Ostmann
Automatically set the view mode (Reading, Live Preview, Source) for notes in Obsidian using folder rules, file patterns, or frontmatter.
Banners Reloaded
8 months ago by Dani García
Banners Reloaded offers a simple, fast, and lightweight way to add beautiful and customizable banners to your Obsidian notes. Designed for performance, it gives you powerful control over your vault's appearance through an intuitive interface. Set banners globally, by tag, or override them on any individual note.
Link Tree
3 years ago by Joshua Tazman Reinier
A sidebar foldable list of Obsidian link hierarchies.
Binary File Manager
5 years ago by qawatake
An Obsidian plugin to manage binary files
Rich Foot
2 years ago by Justin Parker
🦶 Obsidian plugin that adds backlink/outlink tags and created/modified dates to the footer of your notes
Objects
2 months ago by Finn
NetClip
2 years ago by Elhary
this plugin is for Obsidian that allows you to browse the web and clip webpages directly into your vault.
Conditional Properties
10 months ago by Diego Eis
Automate frontmatter property updates in your Obsidian notes using simple conditional rules.
Auto Tag
3 years ago by Control Alt
Easily generate relevant tags for your Obsidian notes.
Media Companion
2 years ago by Nick de Bruin
Bases Toolbox
4 months ago by Grub Basket
Adds Quality of Life features to Obsidian Bases
Metadata Auto Classifier
2 years ago by Beomsu Koh
Obsidian plugin that uses AI providers to generate tags and frontmatter metadata for your notes.
Metadata Icon
3 years ago by Benature
change metadata entry icon
Bulk Exporter
3 years ago by symunona
Bulk export Markdown filtered, renamed and sorted by front matter metadata into a new structure.
Content Cards
2 years ago by leo
Insert content cards in Markdown, such as timeline, highlightblock, target card, book information card, music information card, movie information card, photoes ablum, business card, content subfield, countdown, SWOT,BCG.
Frontmatter generator
3 years ago by Hananoshika Yomaru
A plugin for Obsidian that generates frontmatter for notes
Update Time
2 years ago by Sébastien Dubois
Obsidian plugin that updates front matter to include creation and last update times
Metadata Validator
3 months ago by flowing-abyss
Manifest-driven metadata validation for Obsidian.
Notes dater
3 years ago by Paul Treanor
Adds created_on and updated_on dates of the active note to status bar
Linked Data Vocabularies
4 years ago by kometenstaub
Add linked data to the YAML of your Obsidian notes.
Kanban Status Updater
2 years ago by Ankit Kapur
Obsidian plugin that automatically updates the note property when card is moved to a column.
KoReader Highlight Importer
2 years ago by Tahsin Kocaman
Imports highlights and metadata from KoReader into Obsidian notes
Open Related Url
4 years ago by Dan Pickett
FuzzyTag
4 years ago by Adrian
Add an ID to the front matter
3 years ago by llimllib
Frontmatter Alias Display
4 years ago by muhammadv-i
A plugin for Obsidian.md to show front-matter aliases as display names in the file menu.
Nav Link Header
2 years ago by ahts4962
Display navigation links at the top of the notes in Obsidian
Default query in backlinks
3 years ago by Benature
Bulk Tag Manager
3 months ago by ducktapekiller
A comprehensive utility to standarize the entire front matter. Features a dashboard for bulk renaming, enforcing casing rules (lowercase/uppercase), swapping separators (snake/kebab), and generating master tag lists.
Symbol linking
a year ago by Evan Bonsignori ; Mara-Li
Adds ability to link with any trigger in Obsidian. Each trigger can limit linking to specific folders or file.
Auto Front Matter
3 years ago by conorzhong
File Title Updater
2 years ago by wenlzhang
An Obsidian plugin that synchronizes titles between filename, frontmatter, and first heading in your notes.
Hierarchical Backlinks
2 years ago by Jason Motylinski
Plugin which displays backlinks as a tree structure based on file paths
Note aliases
4 years ago by Pulsovi
This plugin manages wikilinks aliases and save them on the aliases list of the linked note
Copy Metadata
3 years ago by wenlzhang
An Obsidian plugin to copy metadata to clipboard and insert it into file name.
Backlink Full Path
2 years ago by mnaoumov
Obsidian plugin that shows the backlink's full path in the backlinks panel.
Gantt this
3 months ago by Altarok
Obsidian plugin showing multiple TTRPG calendars at once in one gantt chart.
Additional Icons
3 years ago by Matthew Turk
Add additional iconsets to Obsidian
Book Clipper
a year ago by Hossein Fardmohammadi
Save book details from websites into your notes
Testing Vault
4 years ago by Michael Pedersen
GitHub Integration
2 years ago by Kirill Zhuravlev
Plugin that fetch your github stars into notes
Note UID Generator
a year ago by Valentin Pelletier
Allow you to automatically generate UID for the notes in your vault.
Sort Frontmatter
3 years ago by Kanzi
Sort frontmatter automatically
File Index
3 years ago by Steffo
Obsidian plugin to create a metadata file about the files present in the Vault
Dataview Autocompletion
2 years ago by Daniel Bauer
Connections
10 months ago by Eric Van Cleve
Auto Move File
2 months ago by sx kan
Automatically move files based on frontmatter properties in Obsidian
Coalesce
a year ago by Floyd
Coalesce is an Obsidian plugin that merges all your linked notes into a single, organized view for a cohesive research and writing experience.
Attachment Organizer
4 months ago by kiteruunner
Automatically organize attachments into zone-based folders with conflict detection and batch operations
Paste Image Into Property
2 years ago by Nito
My Thesaurus
2 years ago by Mara-Li
A plugin that auto tags file based on contents and a csv file or a Markdown table (inspired by https://github.com/pmartinolli/MyThesaurus)
Note Types
3 months ago by jsmorabito
LLM Tagger
2 years ago by David Jayatillake
Antigravity
2 months ago by ke yongcheng
Autonomous vault management, knowledge organization, and agentic intelligence powered by Google Antigravity (agy).
Image Metadata
2 years ago by alexeiskachykhin
Adds image metadata editing capabilities to Obsidian
Another Name
2 years ago by Jiyuan Wang
Add a subheading to your note in Obsidian
Note Codes
a year ago by Ezhik
Reference your Obsidian notes from anywhere with simple 4-character codes.
Understory
5 months ago by Rosetta Zidian Guo
A connection-sustain plugin: find connections and conflicts, update them over time
Update Time Updater
3 years ago by MURATAGAWA Kei
Obsidian plugin to update the 'update time' element when saving or manually.
Simple File Info
2 years ago by Lukas Capkovic
UnLime
a year ago by shandyba
Obsidian Unmentioned Links toggle
Papers
a year ago by William Liang
An obsidian plugin to retrieve and import research papers.
Vault Shelf
2 months ago by Lukas Proprentner
Your Obsidian vault as a browsable library: shelves of books built from titles, dates, people, tags, folders or any note property. Customizable to make it your own.
Pretext Optimizer
4 months ago by wuyifan-code
MD Butler
3 months ago by Peter Petschownik
Automatically manages YAML frontmatter fields for all notes. A reliable alternative to Templater formulas for consistent metadata.
Sentinel
2 years ago by Giorgos Sarigiannidis
A plugin for Obsidian that allows you to update properties or run commands based on document visibility changes.
Mapa neuronal
2 months ago by Felipe Córdova
A graph that explains itself: your Obsidian vault as a layered neural map, with the reason each note links to the next.
Ontomark
a month ago by DreamLab AI
Offline ontology reasoning, SPARQL and reviewed frontmatter edits for Obsidian
Publish Note to Mowen Note
a year ago by ziyou
This is a mowen plugin for Obsidian (https://obsidian.md)
Note Favicon
2 years ago by mdklab
Obsidian plugin – Show Favicon from Metadata
Virus Total Enrichment
2 years ago by ytisf
An Obsidian plugin to enrich a note with VirusTotal API.
ExMemo Assistant
2 years ago by ExMemo AI
Using LLMs to manage files and generating metadata such as tags and summaries.
Notion Suite
2 months ago by craigstfn
Obsidian plugin: Notion-style databases, views, relations, rollups, charts and a / menu
Boardgame Search
2 years ago by Marlon May
A plugin to create notes for boardgames based on the BGG API
Draft Indicator
3 years ago by Brian Boucheron
Show draft status with ✎ icons in the Obsidian file explorer.
Template Folder
a year ago by LucasOe
Obsidian plugin to move notes to a folder when applying a template.
Current File Tags
2 years ago by Trung Tran
Discrete
a year ago by shkarlsson
Choreday
a month ago by Paul Chiu
Obsidian plugin for tracking recurring household chores as plain-markdown notes, with a due list, one-tap done, snooze and skip, and a short history per chore.
F2 Quick Rename
a month ago by 熊猫别熬夜
F2 to quick rename the current note, or an embedded note/image under the cursor (including wiki aliases and markdown image alt text).
Property Panels
4 months ago by Eva Chen
Display and edit Obsidian frontmatter properties in configurable panels that stay inside the note's scrollable content.
Title-Only Tab
2 years ago by tristone13th
a plugin of obsidian for to change showing tab name to short
Watched-Metadata
2 years ago by Nail Ahmed
Watches for changes in metadata and updates the note content accordingly.
Frontmatter to HTML Attributes
8 months ago by Tarek Saier
Frontmatter Metadata Link Classes
a year ago by Varvara Zmeeva / zmeeva.io
Enhanced internal links with automatic classnames based on frontmatter metadata.
Universal UI Translator
2 months ago by feifei
Hephaistos Importer
2 years ago by Skallaturi
Non-official plugin for importing characters from Hephaistos.online to Obsidian.md
Onto Tracker
2 years ago by Jacob Hart
Plugin for obsidian allowing project management with ontologies.
PixNote
3 months ago by Sofia Milton
Anki Helper
9 months ago by Dusk
Coherence Wizard
a month ago by coherence-wizard
Obsidian Plugin With Powerful Tools For Creating Order and Coherence
Insert Arknights URL Banner
a year ago by Rerurate_514
Obsidianのプラグイン、img_dwnldr_wikigg_ak_ktに保存されている画像を選択してbannersプロパティに簡単に設定できるプラグイン
Markdown Tasks
a month ago by jsmorabito