永久链接

提示

该功能仅对博客文章目录（默认为 posts）下的文章生效，并无侵入性，不会改变其他目录文章的 URL

永久链接功能是博客的重要组成部分，使用永久链接后，文章的 URL 不再与 Markdown 文件名相关联，方便后期修改文件名。

开启

默认情况

永久链接功能默认已经开启，主题会自动在构建时为每一篇文章生成一个 6 位的 ID，永久链接由这个 ID 与一个固定前缀 posts 组成。

完整格式为 posts/:id。例如，ID 为 123456，文章的链接便是 /posts/123456

自定义 ID

当然，你也可以通过在 Frontmatter 中自定义文章的 ID 来达到修改永久链接的目的

id: vitepress

此时，文章的链接就变成了 /posts/vitepress

修改前缀

默认情况下，所有的永久链接前缀都为 posts，你可以在 usePosts 方法导入文章列表时，通过 permalink 参数可将其修改

.vitepress/config.ts

const { posts } = await usePosts({ permalink: 'custom' });

此时，文章的链接就变成了 /custom/vitepress

如果你想将永久链接彻底关闭，则可以将 permalink 设置为 '' 空字符串，此时链接将回退回默认的 Markdown 文件路径。

单篇文章

提示

Frontmatter 中的 permalink 优先级最高！

如果只想为一篇文章设置永久链接，只需要在该文章的 Frontmatter 中配置 permalink

permalink: my-first-post

此时，该文章的链接便为 /my-first-post