Header Filename

Header Filename

Automatically renames notes in Obsidian based on the first # Heading in the document.

Features

• Inserts a default heading (# untitled) when creating a new empty note
• Renames the file to match the first H1 heading on every edit
• Converts names to kebab-case (My Note Title → My-Note-Title)
• Translates diacritics to ASCII equivalents (ć → c, ż → z, etc.)
• Collapses duplicate separators (ABC - CD → ABC-CD)
• Configurable debounce delay to avoid excessive file renames
• Batch rename all files from command palette

Settings

Install

1. Clone this repo into your vault's .obsidian/plugins/header-filename/ directory
2. Run npm install && npm run build
3. Enable the plugin in Obsidian → Settings → Community plugins

Releasing

1. Bump version and create a release:

just create-version 1.0.0

This will:

• Update version in manifest.json and package.json
• Commit the changes
• Create a git tag
• Push to GitHub

2. GitHub Actions will automatically build and create a release with the plugin files attached.