# Numbered 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

1. Download the latest plugin release.
2. Extract the plugin into:

```
VaultFolder/.obsidian/plugins/numbered-folder-creator
```

3. Ensure the folder contains:

```
main.js
manifest.json
styles.css
```

4. Open **Settings → Community Plugins** in Obsidian.
5. 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