如何阻止Pandoc将列表内容包裹为段落并避免图片嵌套进列表？

解决方案步骤 #

1. 调整Markdown源文件（针对图片不嵌套进列表项）
   若要让图片和列表项同级而非被包含在<li>内，需去掉图片前的缩进，确保它和列表项处于同一层级：

   1. Lorem ipsum dolor sit amet consectetur adipisicing elit. Hic, reprehenderit.
   2. Lorem ipsum dolor sit, amet consectetur adipisicing elit:
   
   ![example](assets/images/iuacessos-preferences.png)
   
   3. Lorem ipsum dolor sit amet consectetur adipisicing elit. Enim voluptates similique ab doloremque delectus veniam.
   

2. 使用优化后的Pandoc命令
   启用compact_lists扩展并添加--wrap=none参数，让输出更接近GitHub的简洁风格：

   pandoc bug.md -f markdown_github+compact_lists-implicit_figures -t html --wrap=none -o bug.html
   

参数说明 #

• +compact_lists：强制列表项内的单行文本直接放在<li>标签中，不再额外包裹<p>
• --wrap=none：禁用自动文本换行，避免Pandoc为换行生成不必要的块级元素
• -implicit_figures：阻止图片被自动转换为带标题的<figure>元素，保持原生<img>标签结构

转换后的输出结果 #

<ol>
  <li>Lorem ipsum dolor sit amet consectetur adipisicing elit. Hic, reprehenderit.</li>
  <li>Lorem ipsum dolor sit, amet consectetur adipisicing elit:</li>
</ol>
<img src="assets/images/iuacessos-preferences.png" alt="example" />
<ol start="3">
  <li>Lorem ipsum dolor sit amet consectetur adipisicing elit. Enim voluptates similique ab doloremque delectus veniam.</li>
</ol>

补充说明 #

你期望的输出（图片在<ol>内部但不属于任何<li>）其实不符合HTML规范（<ol>的直接子元素只能是<li>）。GitHub渲染会自动修正这种不规范结构，而Pandoc会严格遵循HTML标准。如果需要图片紧跟第二个列表项且保持在有序列表内，建议将图片放在第二个<li>中，通过CSS控制样式而非修改HTML结构。

内容的提问来源于stack exchange，提问作者Oo'-