解决 pandoc渲染插件 图片下方出现两次caption的问题
2025.04.18
问题描述
逛自己博客的时候看到如下情况：
图片描述在图片正下方显示了一次，又在下方偏左的地方显示了第二次。
当图片描述非空的时候不会出现上述情况：
两次图片描述的字体还不一样，有点强迫症，希望能把第二次描述的文字去除。
解决方法
F12 看到出现问题的页面源代码如下：
<figure>
<img src="/images/OO_image/Adventurer.png" alt="Adventurer">
<figcaption>Adventurer</figcaption>
</figure>要解决问题，我们得想办法去掉 <figcaption>Adventurer</figcaption>
查找资料后，我找到一篇博文提供了解决方法Hexo NexT 图片caption出现多次 | wylu
在顶层文件 _comfig.yml 文件中， pandoc 条目下加上 extensions: - '-implicit_figures'。修改之后，我的相关配置如下：
pandoc:
args:
- "--mathjax"
extensions:
- '-implicit_figures'重新载入Hexo后，问题并未解决，于是我顺着 pandoc 的 -implicit_figures 继续查找解决方法。
在 pandoc-manual 找到扩展说明如下：
如果我们想要一个常规的内联图像，我们需要确保这个照片不是段落的唯一内容，按照样例，我们可以在其后面加反斜杠。
问题解决！
安装并启用 post_asset_folder 插件，修改文件渲染逻辑
我原来采用的方法是启用全局 image 文件夹进行图片渲染。今天晚上在寝室里写 .md 文件，总感觉文件里图片不渲染不得劲，而且只有在生成之后才能看到自己带图片的文章，不能很好地看到问题反馈进行修改。
之前在选择渲染方式的时候也看到过其他可以解决的办法，但是当时偷懒没搞 于是我想着用换一种方式。
最后选择启用并安装 post_assert_folder 插件。只是这样之后需要忍受图片文件夹和 .md 同处一个文件夹的困扰。
参考：hexo中图片无法加载 - CodeNow99 - 博客园
正文内部成对半角小括号渲染问题
2025.05.21
问题描述
今天把OO课程第三单元感受写完了，但是遇到一个问题，就是与 .md 文件关联的同名文件夹中的图片提交不上去。最后瞎搞，往里面多加了一张图片，重新生成提交就有图片了，删除多加的图片后也没有问题。
然后我在网页中翻文章。看到以下情况
对应的 md 文件中的源代码是这样的
疑似是某个渲染文件把半角小括号渲染成了其他格式，导致文章中不仅不能渲染成对半角小括号，而且会更改正文的字体。并且我还挺喜欢用半角小括号的所以我想尝试解决一下问题。
解决方法
找到篇大大的博文，描述了类似的问题：MathJax常见问题 | DaNing的博客
总结一下：在blog\themes\hexo-theme-matery\layout\post.ejs文件中修改以下代码
// old
tex2jax: {inlineMath: [['$', '$'],['\(', '\)']]}
// new
tex2jax: {inlineMath: [['$', '$'],['\\(', '\\)']]}
// or new
tex2jax: {inlineMath: [['$', '$']]}我替换成了更严格匹配的括号对(第一种)
