在 GitHub Pages 内容中 @mention 用户名会怎样显示?

在 GitHub Pages 页面内容里写 @用户名，会生成一个指向该用户 GitHub 个人资料的链接，点击后进入对方的 GitHub Profile 页面。这一效果来自 GitHub Pages 对 GitHub Flavored Markdown 的支持，适合用来标注作者、贡献者或致谢对象。适用条件是：页面内容以 Markdown 撰写并经由 GitHub Pages 发布；如果页面是纯手写 HTML 且未经过 Markdown 渲染，则不能指望 @ 自动变成链接。

机制：@mention 如何变成链接

GitHub Pages 默认支持 GitHub Flavored Markdown（GFM）。在 GFM 中，@ 后紧跟一个合法的 GitHub 用户名，会被解析为指向 https://github.com/用户名 的链接，显示文本通常就是 @用户名。

输入与预期结果对照：

页面资料中的示例正是这种用法：介绍 GitHub 创始人时写成 Chris Wanstrath（@defunkt）、PJ Hyett（@pjhyett）、Tom Preston-Werner（@mojombo），三个用户名都会链接到各自的 GitHub Profile。这说明 @mention 的典型场景是“作者与贡献者”标注，而不是普通正文里的装饰。

使用时的几个实际注意点

用户名要真实存在

@mention 依赖用户名解析。拼错或使用不存在的用户名，通常不会得到有效链接，读者点击后可能落到 404。发布前逐个点开验证是最稳妥的做法。

前后要有分隔

@ 紧贴在其他单词后面（例如 email@example）不会被当作 mention。想稳定触发，把 @用户名 放在空格、标点或行首之后。

与代码块区分

写在行内代码或代码块里的 @用户名 会按代码原样显示，不会变成链接。如果你在教程里演示 mention 语法，这一点反而有用。

手动建站时同样成立

页面资料说明，除了自动生成器，也可以向仓库推送名为 gh-pages 的分支来手动创建页面，并支持 Jekyll 静态站点生成器。只要内容经过 GFM 渲染，@mention 的链接行为一致；用 Jekyll 时还可以把贡献者列表集中写在布局或数据文件里，避免每页重复维护。

什么时候该用、什么时候不必用

• 适合用：文章末尾的作者署名、贡献者致谢、多人协作项目的成员介绍。一个 @用户名 同时完成了“显示名字”和“给出主页入口”两件事。
• 不必用：正文中随口提到某人、或对方没有 GitHub 账号时。此时直接写名字更清楚，也不会产生失效链接。
• 替代做法：需要控制链接文字时，用标准 Markdown 链接 [显示文字](https://github.com/用户名)，显示效果更可控。

如果页面发布后 mention 没有变成链接，先确认内容是否为 Markdown 而非纯 HTML，再检查用户名拼写与 @ 前后的分隔符；仍无法解决时，可查阅 GitHub Pages 官方文档或联系支持。