What is the recommended workflow for renaming Markdown files?

[douglaslassance]

Currently, if I want to move or rename a markdown file, I need to manually make sure all references to this file are being updated. It's completely logical, but also slightly inconvenient and error-prone. I was wondering if there was a suggested workflow to simplify that experience. I am currently editing using Visual Studio Code.

[beatreichenbach]

If you use an IDE like PyCharm, and rename/refactor files, there's an option to search for references which will automatically rename all those references as well.

[brc-dd]

On vscode, you can configure markdown.updateLinksOnFileMove.enabled in settings. You'll still need to update config files (sidebar/navbar mainly) or if you're using path or file name in vue components, etc. I personally just prefer using project wide search and replace.

Screen.Recording.2025-02-27.at.11.25.53.PM.mov

[douglaslassance]

Thanks for the tip @brc-dd, it works pretty well. I wish it saved the files that are being altered by the move. Also, the sidebar won't update since it is defined in the config.mts file. Maybe there is a way to declare the sidebar in Markdown. Also worth mentioning that for this to work, the path needs to be a valid relative or absolute path.

[brc-dd]

To save all the files you can follow this - https://stackoverflow.com/a/42618401/11613622

opt+cmd+s works on mac

It keeps them open so that you can review the changes before saving.