Hexo Blog 的一些技术细节
花了一些时间总算搞好了,第一篇文章就简要记录一下踩的坑吧。
数学公式渲染
处于兼容性考虑,我采用了 Mathjax 作为 math
engine,同时将默认 Markdown 渲染器换成了
pandoc
一定要把之前的渲染引擎删除干净,否则会有一些很诡异的错误
英文引号变成中文
我想写这篇文章的罪魁祸首。
一开始,所有的英文引号 '/" 都会被渲染成
‘/“,显示效果奇差无比
查询之后发现这也是渲染引擎的问题,它会自动开启一个类似于 formatting 之类的操作
Github 上比较常见的几个 issue 都是用的
hexo-renderer-marked
但是如上文所说,我换成了 pandoc
之后依然有这个问题(有的文章说换 pandoc
之后就好了),猜测也有一个类似的开关
随问 LLM,发现要传入一些参数: 1
2
3
4
5pandoc:
args:
- '--from'
- 'markdown-smart' # 这里的 -smart 表示在 markdown 解析中禁用 smart 扩展
- '--mathjax'
我估计可能是因为 pandoc 版本的不同,旧版本的默认关闭/没有 smart 扩展