Hexo下的一些配置问题

EliorFoy Lv3

1. Obsidian与Hexo的差异

\qquad首先是obsidian与Hexo的配合使用,虽然都是使用markdown,但是obsidian的渲染有个头疼之处就是首行缩进效果不好,而且默认不会加上空格,也就导致Hexo在渲染的时候首行都是不会空格的,虽然尝试了使用转义字符,但是obsidian还有bug,在“实时阅览”的模式下,转义字符不会被转义显示,这就显得非常的别扭了,踩了许多坑之后使用latex的\quad做代替就能当做两个空格了,个人认为是最好的解决办法。当然如果不用obsidian用typora就一点问题也没有~

2. 数学公式的渲染

\qquadredefine主题官方采用的是Mathjax 数学公式 | Hexo Theme Redefine Docs,但是经过个人尝试,渲染效果不佳,即使配合pandoc渲染依旧达不到想要的效果甚至出错(页面渲染出来很乱,可能是语法上面冲突了)。我本来的方案是使用hexo-renderer-markdown-it-plus更换了Hexo默认的渲染器,本来用着还挺好的,支持emoji等等hexo默认渲染器不支持的语法,但是有时候就莫名渲染出问题了,有些公式能渲染有些公式又渲染不出来了;还有就是虽然这个插件使用的是katex,但是效果却有点丑:
image-2025729555113.png
\qquad接受不了于是准备换一个,又尝试了这个别人fork后更改的版本依旧出现渲染问题,知道遇到这篇博客文章Hexo博客渲染KaTeX数学公式 | Feng’s Blog,他提到此渲染器默认包含且开启了 @iktakahiro/markdown-it-katex 插件,可渲染 11.1 版本以前的 KaTeXKATE​X 公式。但 KaTeXKATE​X 自 13.0 开始渲染机制发生了变化,需要更换为 @andatoshiki/markdown-it-katex 插件.而后按照博客中的方法:

1
2
npm install katex
npm install @andatoshiki/markdown-it-katex

\qquad在_config.yml添加:

1
2
3
4
5
6
7
8
9
markdown_it_plus:
# ...
plugins:
- plugin:
name: '@iktakahiro/markdown-it-katex'
enable: false
- plugin:
name: '@andatoshiki/markdown-it-katex'
enable: true

\qquad配置好inject的css后就渲染成功了,而且还变美观了:
image-202572995849.png

3. 矩阵反斜省略号的渲染问题

\qquadlatex语法虽然支持斜省略号\ddots但是却不支持反斜省略号,这就导致如果想要渲染类似于这样的矩阵就很难办了:
image-20257291250695.png
\qquadlatex中可以通过旋转命令来实现反斜省略号,但是markdown中并不支持,好在找到了解决办法,即通过点和移动点的位置构造一个自己的反斜省略号:

1
\mathinner{\kern1mu\raise1pt{.}\kern2mu\raise4pt{.}\kern2mu\raise7pt{\Rule{0pt}{7pt}{0pt}.}\kern1mu}

\qquad渲染效果就已经做到比较对称和美观了。
\qquad随之而来的问题是Katex并不支持该\raise语法,但是它支持raisebox语法,于是作修改:

1
\kern1mu \raisebox{1pt}{.} \kern2mu \raisebox{4pt}{.} \kern2mu \raisebox{7pt}{.} \kern1mu

\qquad渲染结果可以通过Katex官网KaTeX – The fastest math typesetting library for the web进行查看。至于该Katex语法Markdown并不支持,并且似乎没有找到Obsidian支持Katex渲染的插件,那就只好将发布的文章和本地的文章作两个版本存储了,将本地的版本的Front-Matter部分配置published参数为false即可忽略发布,参见如何优雅隐藏 Hexo 文章 | CC的部落格

4. 最后

\qquad最后感谢一下提到的这些前辈的分享!然后展望一下以后增加的效果:

  • 标题: Hexo下的一些配置问题
  • 作者: EliorFoy
  • 创建于 : 2025-07-29 18:51:52
  • 更新于 : 2025-07-29 19:36:04
  • 链接: https://eliorfoy.github.io/2025/07/29/文章管理/Hexo下的一些配置问题/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论