Renaming notes

Renaming a note through settle comes with the benefit that all links to the former title are updated, which means that links (almost) never break.

You can rename a note by using the settle sync --rename <FROM> <TO>. Titles here are matched exactly, as using regex could match multiple notes.

Here are two examples:

settle sync --rename "PSYCHOLOGY" "Psychology" renames "PSYCHOLOGY" to "Psychology"
settle sync --rename "Neuroology" "Neurology" renames the note called "Neuroology" to "Neurology"

Errors

if the specified old title doesn't exist, then an error is returned
if there is already a note with the new title provided, then an error is returned and the overwrite is prevented.