使用Pandoc从含内联HTML的Markdown生成PDF时<i>标签失效问题

我之前也碰到过一模一样的场景——为了兼容iaWriter混用Markdown和HTML，结果Pandoc转PDF时部分inline标签直接失效。下面给你几个实用的解决方案，按省心程度排序：

1. 优先用Markdown原生斜体语法（最稳妥） #

其实iaWriter完全支持Markdown的斜体写法：_not_ 或者 *not*，显示效果和<i>not</i>完全一致。这种写法既在iaWriter里正常渲染，Pandoc也能100%识别转换，不需要任何额外配置，是最省心的方案。

2. 启用Pandoc的native_spans扩展 #

如果你的场景必须用HTML <i>标签（比如复杂嵌套或特殊格式需求），可以在命令里明确启用native_spans扩展，它能让Pandoc把HTML inline标签转换成原生的格式元素，转PDF时就能正确映射到LaTeX的斜体样式。

执行命令：

pandoc -o test.pdf --from markdown+raw_html+native_spans test.md

这里raw_html确保Pandoc解析HTML标签，native_spans则把<i>这类inline标签转换成Pandoc内部的斜体（Emph）元素，最终生成PDF时就会正常生效。

3. 用Lua过滤器强制转换HTML <i>标签 #

如果上面的扩展还是不生效，可以写一个简单的Lua过滤器，专门捕获<i>...</i>并转换成Pandoc的斜体格式。

操作步骤： #

1. 创建一个名为html-italic.lua的文件，内容如下：

function RawInline(raw)
  if raw.format == "html" then
    -- 匹配完整的<i>内容标签
    local content = raw.text:match("^<i>(.*)</i>$")
    if content then
      return pandoc.Emph(pandoc.Str(content))
    end
  end
end

2. 执行转换命令时指定这个过滤器：

pandoc -o test.pdf --lua-filter html-italic.lua test.md

这个过滤器会把所有<i>文本</i>的HTML标签替换成Pandoc原生的斜体元素，转PDF时自然会正确渲染。

为什么<p>标签生效而<i>不生效？ #

Pandoc对block级HTML元素（比如<p>、<div>）的处理逻辑更宽松，默认就会转换成对应的段落/块级结构；但inline级HTML元素（比如<i>、<b>）需要特定扩展（如native_spans）或额外处理，否则会被当作纯文本忽略，这就是你看到<p>正常工作但<i>没效果的核心原因。

内容的提问来源于stack exchange，提问作者Mills