Moving and renaming files¶

A documentation project outgrows its folder structure as it evolves. Moving or renaming a Markdown file is a normal part of that. However, this means finding and fixing every relative link and snippet path that points at the old location, across all content that references the file. Doing this by hand is tedious and error-prone.

Move or rename a file in the Explorer¶

Use the ExplorerExplorerProject panelProject tool window to move or rename a Markdown page, image, or reusable snippet file, the way you normally would. Zensical Studio updates the links and snippet paths on other pages that pointed to it, so they keep pointing at the same destination from its new location:

Zensical Studio updates the link to the automation page in index.md. It also rebases the relative links and snippet paths inside the moved file itself, so content that references other files still resolves correctly afterwards.

When you have Studio running and move files within Visual Studio CodeCursorZedJetBrains IDEs, all links are updated automatically.