Hexo博客折腾日记


解决 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 - 博客园


文章作者: Yiyuan Qi
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 Yiyuan Qi !