在C# .NET 8.0中使用iText7转换含MathJax的JS HTML至PDF时，MathJax公式无法渲染的问题

我之前处理MathJax转PDF时踩过一模一样的坑——网页上公式显示得好好的，转成PDF就变成了原始LaTeX代码或者占位符，大概率是你没等MathJax彻底完成公式渲染，就触发了PDF转换，或是没拿到已经渲染完成的DOM内容。下面给你几个亲测有效的解决步骤：

1. 核心：等待MathJax完全完成渲染 #

MathJax的加载和公式排版是异步的，哪怕页面DOM加载完成，它可能还在后台处理公式。你可以通过Selenium的JS执行器，等待MathJax的就绪状态：

// 初始化Headless Chrome
var options = new ChromeOptions();
options.AddArgument("--headless=new");
options.AddArgument("--disable-gpu");
using var driver = new ChromeDriver(options);

// 加载目标页面（本地HTML路径或线上URL）
driver.Navigate().GoToUrl("你的页面地址");

// 用WebDriverWait等待MathJax完成排版
var jsExecutor = (IJavaScriptExecutor)driver;
var wait = new WebDriverWait(driver, TimeSpan.FromSeconds(15)); // 超时时间可根据页面复杂度调整

// 等待条件：MathJax已加载、就绪，且无正在运行的排版任务
wait.Until(d => (bool)jsExecutor.ExecuteScript(@"
    return typeof MathJax !== 'undefined' && MathJax.isReady && !MathJax.typeset.running;
"));

// 可选：复杂页面多等1-2秒，确保所有公式渲染完毕
Thread.Sleep(1500);

2. 抓取渲染后的完整HTML #

别直接用原始HTML字符串，一定要从Selenium中获取当前页面已渲染好的DOM内容，这样拿到的才是带有MathJax生成的SVG/CSS公式的HTML：

// 获取渲染后的完整页面HTML
var renderedHtml = (string)jsExecutor.ExecuteScript("return document.documentElement.outerHTML;");

3. 用iText7处理渲染后的HTML #

把刚才拿到的渲染后HTML传给iText7的HtmlConverter，而非原始未渲染HTML，同时配置基础路径确保资源正常加载：

// 配置iText7转换属性
var converterProperties = new ConverterProperties();
// 设置基础URI（本地HTML的话，填文件所在目录路径）
converterProperties.SetBaseUri(Path.GetDirectoryName("你的本地HTML文件路径"));

// 生成PDF
using var outputStream = new FileStream("最终输出.pdf", FileMode.Create);
HtmlConverter.ConvertToPdf(renderedHtml, outputStream, converterProperties);

额外注意事项 #

• 如果用CDN加载MathJax，Headless Chrome可能有加载延迟，建议把MathJax库下载到本地，用本地路径引用，避免网络导致的渲染不完整
• 可调整MathJax配置，比如设置MathJax.config.chtml.scale = 1.2;来放大公式，确保PDF中显示清晰
• 确保iText7的itext7.pdfhtml包是最新版本，旧版本对MathJax常用的SVG渲染输出支持可能不足

备注：内容来源于stack exchange，提问作者Mohammad Awad