Obsidian Stats logoObsidian Stats

Note Bundler

by jrockwar
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Export bundles of notes into a single markdown file.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Note Bundler

Export filtered Obsidian notes into consolidated Markdown files. Perfect for preparing LLM context, documentation packages, or curated note collections.

Features

  • Tag-based filtering with regex support (include/exclude patterns)
  • Directory include/exclude rules (recursive, vault-relative)
  • AND/OR logic to combine multiple rules
  • Manual and scheduled auto-exports (minute/hour/day intervals)
  • Vault-relative or absolute output paths (desktop only)
  • Cross-platform compatibility
  • Device-specific settings (independent configs per device)

Note Bundler Settings

Installation

  1. Clone this repository
  2. npm install && npm run build
  3. Copy main.js and manifest.json to .obsidian/plugins/note-bundler/ in your vault
  4. Enable in Obsidian → Settings → Community plugins

Development: Symlink the repo folder into .obsidian/plugins/note-bundler and run npm run dev.

Usage

1. Configure Output Location

Settings → Note Bundler → Default output folder
Use vault-relative paths like Exports/ or docs/bundles/. On desktop, you can also use absolute paths like /Users/john-doe/Documents/NoteBundles/.

2. Create Filters

  1. Click Create new filter
  2. Name it (e.g., "Project Notes")
  3. Add rules:
    • Match tags by regex - Include matching notes
    • Exclude tags matching regex - Exclude matching notes
    • Include directory (recursive) - Include notes inside a vault-relative folder
    • Exclude directory (recursive) - Exclude notes inside a vault-relative folder
  4. Combine rules with AND/OR operators

Tag regex examples:

  • #project - exact tag
  • #project.* - tags starting with #project
  • #(important|urgent) - multiple tags

N.B. Tags are not treated as case-sensitive (e.g., #Project and #project are the same), so you don't need to worry about case in the regex - it will pick up both.

Directory rule examples (vault-relative):

  • journals/ - everything in journals/ and subfolders
  • Projects/ClientA - only that subtree (case-sensitive)

3. Export

Manual: Click Export now in settings
Auto: Enable auto-export and choose frequency (minute/hour/day)

Output Format

# Notes combined on: 2026-01-19 12:00:00

---

# Note title: Project Overview

Project overview content with **formatting** and [[links]] preserved.

---

# Note title: Research Notes

Research findings and citations...

Device-Specific Settings

Each device maintains independent plugin settings automatically - no sync conflicts. Configure different export paths and schedules per device without any setup.

Development

Symlink the repo folder into .obsidian/plugins/note-bundler and run npm run dev for live development with hot reloading.

Troubleshooting

  • Export fails: Check output path permissions
  • No notes exported: Verify filter rules and tag spelling
  • Auto-export not running: Check plugin permissions
  • Debugging: Check developer console, test with simple patterns first

Contributing

Contributions welcome! Fork, create a feature branch, and submit a PR.

License

GPL-3.0 - see LICENSE for details.

Changelog

See CHANGELOG.md for version history and updates.

Sponsors