Hexo下的一些配置问题

1. Obsidian与Hexo的差异
首先是obsidian与Hexo的配合使用,虽然都是使用markdown,但是obsidian的渲染有个头疼之处就是首行缩进效果不好,而且默认不会加上空格,也就导致Hexo在渲染的时候首行都是不会空格的,虽然尝试了使用转义字符,但是obsidian还有bug,在“实时阅览”的模式下,转义字符不会被转义显示,这就显得非常的别扭了,踩了许多坑之后使用latex的\quad
做代替就能当做两个空格了,个人认为是最好的解决办法。当然如果不用obsidian用typora就一点问题也没有~
2. 数学公式的渲染
redefine主题官方采用的是Mathjax 数学公式 | Hexo Theme Redefine Docs,但是经过个人尝试,渲染效果不佳,即使配合pandoc渲染依旧达不到想要的效果甚至出错(页面渲染出来很乱,可能是语法上面冲突了)。我本来的方案是使用hexo-renderer-markdown-it-plus更换了Hexo默认的渲染器,本来用着还挺好的,支持emoji等等hexo默认渲染器不支持的语法,但是有时候就莫名渲染出问题了,有些公式能渲染有些公式又渲染不出来了;还有就是虽然这个插件使用的是katex,但是效果却有点丑:
接受不了于是准备换一个,又尝试了这个别人fork后更改的版本依旧出现渲染问题,知道遇到这篇博客文章Hexo博客渲染KaTeX数学公式 | Feng’s Blog,他提到此渲染器默认包含且开启了 @iktakahiro/markdown-it-katex
插件,可渲染 11.1 版本以前的 KaTeXKATEX 公式。但 KaTeXKATEX 自 13.0 开始渲染机制发生了变化,需要更换为 @andatoshiki/markdown-it-katex
插件.而后按照博客中的方法:
1 | npm install katex |
在_config.yml添加:
1 | markdown_it_plus: |
配置好inject的css后就渲染成功了,而且还变美观了:
3. 矩阵反斜省略号的渲染问题
latex语法虽然支持斜省略号但是却不支持反斜省略号,这就导致如果想要渲染类似于这样的矩阵就很难办了:
latex中可以通过旋转命令来实现反斜省略号,但是markdown中并不支持,好在找到了解决办法,即通过点和移动点的位置构造一个自己的反斜省略号:
1 | \mathinner{\kern1mu\raise1pt{.}\kern2mu\raise4pt{.}\kern2mu\raise7pt{\Rule{0pt}{7pt}{0pt}.}\kern1mu} |
渲染效果就已经做到比较对称和美观了。
随之而来的问题是Katex并不支持该\raise
语法,但是它支持raisebox
语法,于是作修改:
1 | \kern1mu \raisebox{1pt}{.} \kern2mu \raisebox{4pt}{.} \kern2mu \raisebox{7pt}{.} \kern1mu |
渲染结果可以通过Katex官网KaTeX – The fastest math typesetting library for the web进行查看。至于该Katex语法Markdown并不支持,并且似乎没有找到Obsidian支持Katex渲染的插件,那就只好将发布的文章和本地的文章作两个版本存储了,将本地的版本的Front-Matter
部分配置published
参数为false
即可忽略发布,参见如何优雅隐藏 Hexo 文章 | CC的部落格。
4. 最后
最后感谢一下提到的这些前辈的分享!然后展望一下以后增加的效果:
- AI 文章摘要
- 文章阅读时长估计
- obsidian的hexo发布插件
- 鼠标特效
- 完整的音乐播放
- Markdown语法彩色提示块支持 - AceCollins - 博客园
- 标题: 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 进行许可。