obsidian-plugin/mnaoumov_obsidian-smart-rename
1
0
Fork 0
mirror of https://github.com/mnaoumov/obsidian-smart-rename.git synced 2026-07-22 07:40:32 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
mnaoumov_obsidian-smart-rename/demo-vault/Smart rename.md
Michael Naumov fdb5c2c07b feat: add demo vault 
Ship a curated demo-vault/ for Smart Rename, bootstrapped by the release-injected
obsidian-dev-utils demo-vault-helper. Notes walk through renaming a note while
preserving backlink display text, handling invalid characters, and every setting.
Add a static registerDemoVaultCoverageSuite no-app test that keeps the demo vault
in sync with the PluginSettings surface, the project dprint.json (excludes
demo-vault), and the README demo vault access section.
2026-07-20 02:08:56 -06:00

1.3 KiB
Raw Blame History

Docs

Smart rename

Smart Rename renames the active note and rewrites its backlinks so their display text keeps showing the old title. A plain rename would change the visible link text to the new name; Smart Rename turns [[Old title]] into [[New title|Old title]] so the reader still sees what you originally wrote.

Try it

  1. Open Rename me (the note this demo renames).
  2. Run Smart Rename: Invoke from the Command Palette, or right-click the note in the file explorer and choose the smart rename option.
  3. Type a new title - for example Renamed note - and confirm.
  4. Open References/Note A and References/Note B. Their links now point at the new note, but still display the old title.

What it preserves

  • Note links - a bare [[Rename me]] becomes [[Renamed note|Rename me]], keeping the old text visible (controlled by the note-links setting in Settings).
  • Frontmatter links - links inside YAML frontmatter get the same treatment (controlled by the frontmatter-links setting).
  • The first header and a title key - optionally kept in sync with the new name (see Settings).

Renaming to a title that contains characters Obsidian cannot use in a filename is handled separately - see Invalid characters.