💡
原文中文，约1600字，阅读约需4分钟。
📝
内容提要
本文讨论了 GitHub Pages 博客文章标题以 @ 开头导致的显示问题。由于 YAML 语法规则，标题不能以特定字符开头。解决方法是将标题用引号括起来或修改标题。
🎯
关键要点
- GitHub Pages 博客文章标题不能以特定字符（如 @）开头，因 YAML 语法规则限制。
- 解决方法包括将标题用引号括起来或修改标题以避免这些字符在开头。
- YAML 中有一些指示字符，不能用作不带引号的标量的第一个字符。
- 在 Jekyll 中，文章头部使用 YAML Front Matter 定义元数据，错误信息提示了标题字符的问题。
❓
延伸问答
为什么 GitHub Pages 的文章标题不能以 @ 开头？
因为 YAML 的语法规则限制，特定字符如 @ 不能作为标题的第一个字符。
如何解决 GitHub Pages 标题以 @ 开头的问题？
可以将标题用引号括起来，或修改标题以避免以 @ 开头。
YAML 中有哪些字符不能作为标题的开头？
YAML 中不能作为标题开头的字符包括 ,[]{}#&*!|>'"%@` 和 -?:。
Jekyll 中的 YAML Front Matter 是什么？
YAML Front Matter 是 Jekyll 用来定义文章元数据的部分。
如果标题以 @ 开头，GitHub Pages 会出现什么错误？
会出现 YAML Exception 错误，提示字符不能作为任何标记的开始。
在 YAML 中，如何安全地使用特殊字符？
最好将特殊字符用引号括起来，避免直接放在字符串开头。
➡️
