README file from
GithubNumbered Folder Creator
Numbered Folder Creator is an Obsidian plugin that automatically maintains sequential numbering for folders and notes to help keep your vault organized.
When a new file or folder is created inside an existing directory, the plugin assigns the next available number prefix to maintain a consistent structure.
Features
Automatic Sequential Numbering
Newly created files and folders inside a directory automatically receive a sequential number prefix.
Example:
Projects
├── 01 Research
├── 02 Documentation
├── 03 Design
If a new folder named Planning is created, the plugin renames it to:
04 Planning
Works With Files and Folders
The plugin supports numbering for both folders and markdown files.
Example:
Notes
├── 01 Introduction.md
├── 02 Concepts.md
├── 03 Examples.md
Preserves File Extensions
File extensions remain unchanged during renaming.
Example:
Report.md → 01 Report.md
Intelligent Detection
The plugin avoids interfering with existing structures.
It ignores:
- Files or folders that already start with a number
- Temporary placeholder names such as
Untitled - Items created in the vault root directory
Retroactive Numbering Command
The plugin includes a command that numbers existing folders and notes.
Command:
Retroactively Number All Subfolders and Notes
This command scans subfolders and assigns numbers to items that do not already have a prefix.
Example Folder Structure
Before numbering:
Projects
├── Research
├── Documentation
├── Design
After numbering:
Projects
├── 01 Research
├── 02 Documentation
├── 03 Design
Installation
Manual Installation
- Download the latest plugin release.
- Extract the plugin into:
VaultFolder/.obsidian/plugins/numbered-folder-creator
- Ensure the folder contains:
main.js
manifest.json
styles.css
- Open Settings → Community Plugins in Obsidian.
- Enable Numbered Folder Creator.
Safety and Behavior
To ensure safe operation, the plugin includes several safeguards:
- Existing numbered items are never modified.
- The vault root directory is ignored.
- Temporary placeholder names are skipped.
- Internal safeguards prevent recursive rename loops.
The plugin only adds numbering to newly created items and does not modify existing organized structures.
License
MIT License