Hexo写作系列(3) - 文章标题含有双引号"导致页面渲染失败无法打开

问题

在用Hexo写文章时，如果文章标题含有双引号"，也就是说如果在文件头里的title出现双引号，如下：

---
title: Hexo - 文章标题含有双引号"导致页面渲染失败无法打开
---

由于这里的写法属于yml语法，双引号属于特殊符号，上述的title的写法就会在执行hexo g时报错，当我们在浏览器里打开这篇文章的页面时就会渲染失败无法打开。

解决方法

我们需要对这里的双引号进行转义，对于这些特殊字符，可以用对应的HTML字符实体来替换。

对于双引号，其字符实体是"或者"。

最终我们在hexo文章的文件头里，应该这样写：

---
title: Hexo - 文章标题含有双引号"导致页面渲染失败无法打开
---

补充

当然，对于文件头之外的部分，则是属于markdown语法的部分，此外由于我们的文章会被swig渲染，同样有一些特殊字符，比如 {{}}，如果在代码块之外的地方使用到这些特殊字符，就会报错！对于不同的语言，各自的特殊字符是不一样的。

这里补充下各种常用到的特殊字符的字符实体：

! ! — 惊叹号 Exclamation mark
" " " — 双引号 Quotation mark
# # — 数字标志 Number sign
$ $ — 美元标志 Dollar sign
% % — 百分号 Percent sign
& & & — 与符号(&) Ampersand
' ' — 单引号 Apostrophe
( ( — 小括号左边部分 Left parenthesis
) ) — 小括号右边部分 Right parenthesis
* * — 星号 Asterisk
+ + — 加号 Plus sign
< < &lt; 小于号 Less than
= = — 等于符号 Equals sign
- - &minus; — 减号
> > &gt; — 大于号 Greater than
? ? — 问号 Question mark
@ @ — Commercial at
[ [ — 中括号左边部分 Left square bracket
\ \ — 反斜杠 Reverse solidus (backslash)
] ] — 中括号右边部分 Right square bracket
{ { — 大括号左边部分 Left curly brace
| | — 竖线Vertical bar
} } — 大括号右边部分 Right curly brace

如果想要在文章中使用空格，直接输入空格是没用的，同样可以使用字符实体来代替，即 。这个代表不间断空格：non-breaking space。

参考链接

• Hexo 特殊符号的转义问题
• HTML 字符实体
• 常用特殊符号的HTML代码(HTML字符实体)