README file from
GithubConcept Indexer
Mechanical concept indexer for Obsidian.
Concept Indexer searches for a concept across your Markdown vault, creates wikilinks, generates master pages with contextual references, and maintains a global concept index.
What's New in v2.1.0
Search Scope
- The search scope panel collapses automatically when Search is clicked, while preserving the selected folders.
Index Destination
- Master pages are always saved in the configured master pages folder, regardless of which folders are searched.
- Searching within a folder no longer creates an additional index destination folder inside that source folder.
What's New in v2.0
Concept Indexer v2.0 introduces cross-reference analysis, safer document processing, and a complete maintenance system for managing changes to your Obsidian vault.
Cross-Reference Analysis
- Discover relationships between two or more indexed concepts.
- Identify documents and content blocks shared by multiple master pages.
- Generate dedicated cross-reference indexes with direct links to related content.
- Automatically link cross-reference indexes from their associated master pages.
Advanced Indexing
- Choose between Expand and Synchronize modes when updating master pages.
- Process multiple folders together or independently.
- Create and maintain master pages and a global index in the configured destination folder.
- Preserve protected Markdown content, including code blocks and existing links.
Change Tracking and Safe Cleanup
- Track wikilinks, hashtags, and block identifiers created or used by the plugin.
- Analyze recorded modifications and identify shared or protected references.
- Preview cleanup operations before modifying documents.
- Remove plugin-generated elements safely while preserving existing and shared content.
- Maintain backups of the change registry during cleanup.
Improved User Experience
- Multilingual interface supporting eight languages.
- Persistent search scope and processing preferences.
- Progress indicators for searches and processing operations.
- Detailed processing summaries.
- Direct access to the online user manual from plugin settings.
Documentation
A new illustrated user manual covers all major features, configuration options, indexing workflows, cross-references, and maintenance tools.
Read the User Manual (English / Español)
Features
- Search concepts across the entire vault or selected folders
- Process folders together or separately
- Create wikilinks automatically
- Generate master pages for concepts
- Create a global concept index
- Add optional hashtags
- Create direct links to headings and block references
- Show contextual excerpts for each reference
- Ignore selected folders
- Persistent settings
- Multilingual interface
Languages
- English
- Español
- Français
- Deutsch
- Português (Brasil)
- Polski
- 日本語
- 简体中文
Installation
Manual installation
- Download the latest release.
- Copy the plugin folder to:
<your-vault>/.obsidian/plugins/concept-indexer/
- Make sure the folder contains:
main.js
manifest.json
- Restart Obsidian or reload the plugins.
- Enable Concept Indexer in:
Settings → Community plugins
Usage
- Open Concept Indexer from the ribbon.
- Enter a concept or select text in a note and use Use selection.
- Choose the search scope.
- Click Search.
- Review the results.
- Select the desired processing options.
- Click Process concept.
Processing options
Wikilinks
Converts matching concept references into Obsidian wikilinks.
Master page
Creates or updates a master page containing links to every note where the concept appears.
References can point directly to:
- headings;
- stable block references.
Context excerpts are included when available.
Hashtag
Optionally adds a normalized hashtag to matching notes.
Global concept index
Concept Indexer maintains a compact global index linking processed concepts to their master pages.
Default file:
Concept Index.md
Default master folder:
Concept Indexer/
Both can be changed in the plugin settings. The master pages folder is used regardless of the selected search scope.
AI-friendly workflow
Concept Indexer can also help prepare your vault for later AI-assisted analysis.
By creating master pages and global concept indexes, it groups references to the same topic in a predictable structure. This allows AI tools, local models, scripts, or external processing pipelines to work from curated thematic entry points instead of repeatedly scanning the entire vault.
In large vaults, this can reduce the amount of content that needs to be processed and make topic-based analysis more efficient, focused, and reproducible.
Settings
You can configure:
- interface language;
- master pages folder;
- global index filename;
- ignored folders.
Privacy
Concept Indexer works locally inside your Obsidian vault.
It does not use:
- AI services;
- external APIs;
- cloud processing;
- telemetry.
License
MIT
Author
Corrosion Labs
Support
If you find Concept Indexer useful and want to support its development: