Skip to content
Documentation

Renaming Aliases

updated

When a document’s alias changes, Meldoc keeps the old alias working as a redirect. The CLI follows it so your repository keeps syncing.

What the CLI does

  • meldoc push with a file that still uses an old alias updates the existing document instead of creating a new one. The file itself is not rewritten.
  • meldoc pull finds the file a renamed document already lives in and updates it in place, keeping the file’s current alias:.

Move a file to the new alias

To bring your repository in line with the new name — the file’s alias: and every [[…]] link pointing at it — run:

meldoc migrate
meldoc validate
meldoc push

Old links keep working in the meantime, so you can do this whenever it suits you. See Renaming & Redirects for renaming in the web.