Hexo问题汇总

MathJax换行符

网上很多在Markdown中插入LaTeX公式的教程中,换行用的\\双反斜杠,在使用默认的渲染引擎时,换行不能生效,使用\newline换行是非法的。笔者猜测是引擎的渲染语义问题,一次偶然的尝试中发现用三反斜杠\\\之后可以解决问题。

但是与下一条问题一样,更换默认的渲染引擎之后可以从根本上解决这个符号语义问题,从而可以使用\\正常换行。

MathJax下划线冲突

Markdown中渲染MathJax公式时,若下划线_随后跟着大括号{},则这段LaTex公式会渲染失败。

解决方案,替换默认的hexo-render-marked引擎:

1
2
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save

更多详细的解决方案细节,观看源博客

因为笔者博客主题使用的Landscape-Plus,在依据其主页指引进行安装之后,需要修改${博客根目录}/themes/landscape-plus/_config.yml中的mathjax选项开关,否则博客内的公式无法正确渲染。

插入图片

貌似Markdown原生的语法不起作用,若用其他方案则因为部署到github.io时不会自动翻译url,即使成功部署图片也会崩掉。

使用命令装上该插件:

1
$ npm install https://github.com/CodeFalling/hexo-asset-image --save # 注1

然后可以:

1
![图片的标题](${图片相对于该文件的路径或者绝对路径})

然后正常在本地,抑或部署都没有问题了。

解决方案源地址

[注1]笔者在最近一次在新机子配置博客开发的环境时,发现直接使用npm install hexo-asset-image --save安装的插件不能正确更新图片的URL,因此改用以上的命令。