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, but by hand it means finding and fixing every relative link and snippet path that pointed at the old location: on every page that referenced it, and inside the file itself.

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 written inside the moved file itself, so content that referenced its neighbors before the move still resolves correctly afterwards.

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