解决 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
同处一个文件夹的困扰。