rename folder feature added. 4s edit wait, 6s cooldown adjust
Some checks failed
Zettelclean CI / build (20.x) (push) Has been cancelled
Zettelclean CI / build (22.x) (push) Has been cancelled
Zettelclean CI / build (24.x) (push) Has been cancelled
Release Zettelclean / build (push) Has been cancelled

This commit is contained in:
2026-07-29 11:07:30 -03:00
parent e83b95c6ee
commit 35cb6dd976
8 changed files with 82 additions and 33 deletions

View File

@@ -38,17 +38,18 @@ slug tail follows. Nothing else is touched.
## How it works
- A note is a zettel when its filename starts with a **TIMEID**: a run of 12 to 18 digits
(a timestamp), for example `20260728145404-my-note.md`. Files without that prefix are
ignored, so plain notes, daily notes, Excalidraw and Kanban files are never renamed.
(a timestamp) followed by any non-digit or the end of the name - so `20260728145404-my-note.md`,
`202607281454.md`, and even `202607281454 my note.md` all qualify. Files without that prefix
are ignored, so plain notes, daily notes, Excalidraw and Kanban files are never renamed.
- The TIMEID is minted **once** and never changes. Only the slug tail is regenerated.
- When you edit the H1, zettelclean waits about 5 seconds of idle, then renames the file to
`TIMEID-slug(H1).md` using Obsidian's own rename (so backlinks are updated). A 10 second
- When you edit the H1, zettelclean waits about 4 seconds of idle, then renames the file to
`TIMEID-slug(H1).md` using Obsidian's own rename (so backlinks are updated). A 6 second
cooldown prevents a just-renamed file from being renamed again.
- Sync is strictly one-way, H1 to filename. Renaming a file by hand is never fought.
- Delete the H1 and the filename collapses back to the bare `TIMEID.md`.
The slug is lowercase, ASCII, dash-separated: accents are folded (`Ciências` becomes
`ciencias`), runs of punctuation and whitespace collapse to a single dash, and leading and
The slug is case-preserving, ASCII, dash-separated: accents are folded (`Ciências` becomes
`Ciencias`), runs of punctuation and whitespace collapse to a single dash, and leading and
trailing dashes are trimmed.
## Creating notes
@@ -70,6 +71,13 @@ Notes created before you adopted this workflow have no TIMEID. Right-click such
file explorer and choose **"Prefix timestamp to filename"**. It mints a fresh timestamp,
prepends it, and the note is now a zettel that syncs on future H1 edits.
## Slugging a folder name
Right-click a folder and choose **"Slug folder name"** to ASCII-clean it in place (this folder
only): `Citações` becomes `Citacoes`. The rename goes through Obsidian, so `[[links]]` into the
folder are updated. It aborts if a sibling of that name already exists, and never touches the
vault root.
## Pretty sidebar (optional)
By default the file explorer shows the slugged filename (with dashes). If you want the sidebar,
@@ -84,7 +92,7 @@ That reads the first H1 directly and falls back to the filename when there is no
## Settings
None. Zettelclean is zero-config in this version. The 5 second settle and 10 second cooldown
None. Zettelclean is zero-config in this version. The 4 second settle and 6 second cooldown
are fixed.
## Development