Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Join the community
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Aggregator

seraphliseraphli4k downloads

Gather information from files, and make a summary in the file.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates7

This plugin helps you gather information from files, and make a summary in the file.

Although it is difficult to write the regular expression, once it's done, it will help you a lot.

Preview

A collection of blocks with a tag. Example1

example1-preview

A collection of annotator blocks with tags. Example2

example2-preview

A stat table that is generated from a folder with custom helper supported. Example3

example3-preview

Usage

Create a code block like this, and set the language to the aggregator. Then this plugin will find content based on RegExp and render the result with the template.

scope:
    - Current File
matches:
    - regex: '(?<=^>%%COMMENT%%\n)(?:(?!^>%%TAGS%%).*\n)+(?=^>%%TAGS%%\n>.*#[a-zA-Z0-9\_]+)'
      template: '{{{result.match.[0]}}}'

If you want to sort the results, you can specify the fields and orders like this.

scope:
    - Current File
    - Papers
matches:
    - regex: '^\w[^\#]*\#[a-zA-Z0-9\_]+\s*$'
      template: '{{{result.match.[0]}}}'
    - regex: '(?<=^>%%COMMENT%%\n)(?:(?!^>%%TAGS%%).*\n)+(?=^>%%TAGS%%\n>.*#[a-zA-Z0-9\_]+)'
      template: '{{{result.match.[0]}}}'
order:
    fields: filename, line
    orders: asc, asc

Argument Explain

Check out Arguments.md.

Example Usage

Check out docs for detailed examples.

Settings

Note the default join string is not empty. It's just the text area can not display \n\n.

File Indicator is a Handlebars template. Available data: file: TFile, index: number starts at 1.

See Also

obsidian-link-embed

Thanks

  • tag-summary
  • tracker
61%
HealthGood
ReviewRisks
About
Gather content from notes using user-defined regular expressions and render summaries with Handlebars templates. Extract blocks, tagged items, or generate stat tables across files or folders and sort results by fields. Preview and embed aggregated output inline.
TemplatingDataSearch
Details
Current version
0.3.1
Last updated
Last year
Created
3 years ago
Updates
7 releases
Downloads
4k
Compatible with
Obsidian 0.15.0+
License
MIT
Report bugRequest featureReport plugin
Author
seraphliseraphli
github.com/Seraphli
GitHubseraphli
  1. Community
  2. Plugins
  3. Templating
  4. Aggregator

Related plugins

Templater

Create and use dynamic templates.

Smart Connections

AI link discovery copilot. See related notes as you write. Lookup using semantic (vector) search across your vault. Zero-setup local model for embeddings, no API keys, private.

Tracker

Track occurrences and numbers in your notes.

Omnisearch

Intelligent search for your notes, PDFs, and OCR for images.

Fantasy Statblocks

Create, manage and view a Fantasy Bestiary with Dungeons and Dragons style statblocks.

Datacore

An even faster reactive query engine for the data obsessed.

MCP Tools

Securely connect Claude Desktop to your vault with semantic search, templates, and file management capabilities.

Periodic Notes

Manage your daily, weekly, and monthly notes.

Meld Encrypt

Hide secrets in your notes.

Kindle Highlights

Sync your Kindle book highlights using your Amazon login or uploading your My Clippings file.