Hexo 出错排查

一. Nunjucks Error

现象描述

Unhandled rejection Nunjucks Error: _posts/xxx.md [Line 84, Column 13] unknown block tag: 标签

解决办法

参考 https://hexo.io/docs/troubleshooting.html#Escape-Contents
https://blog.csdn.net/Calvin_zhou/article/details/109303640

泄露(Escape)内容

Hexo 使用 Nunjucks 来解析文章(旧版本使用 Swig,两者语法类似),内容若包含 {{ }}{% %} 可能导致解析错误,您可以用 raw 标签包裹,single backtick {{ }} 或 triple backtick 来避免潜在问题发生。
Alternatively, Nunjucks tags can be disabled through the renderer’s option (if supported), API or front-matter.

1
2
3
{% raw %}
Hello {{ world }}
{% endraw %}
1
2
3
```
Hello {{ world }}
```