R Markdown中webshot无法渲染Plotly标题LaTeX问题求助

核心原因 #

HTML渲染时，浏览器会自动加载Plotly依赖的MathJax/KaTeX库解析LaTeX公式，但webshot/webshot2这类无头截图工具默认不会等待外部资源加载完成，且Plotly默认的MathJax路径在截图环境中可能无法访问，导致PDF截图里公式无法渲染。

可行解决方案 #

1. 强制Plotly使用CDN版MathJax
   在创建Plotly对象时，通过config()指定加载CDN上的MathJax资源，避免本地路径问题：

   library(plotly)
   # 示例Plotly图形，包含LaTeX公式
   p <- plot_ly() %>%
     add_trace(
       x = c(1, 2, 3),
       y = c(1, 4, 9),
       text = "$y = x^2$", # LaTeX公式
       mode = "text",
       textposition = "top center"
     ) %>%
     config(mathjax = "cdn") # 关键：指定CDN加载MathJax
   

2. 给截图工具添加延迟等待渲染
   使用webshot2时，通过delay参数给无头浏览器足够时间加载MathJax并渲染公式，在R Markdown代码块中设置：

   ```{r plot-with-latex, dev='webshot2', delay=3}
   print(p)
   

   注：`delay`值可根据网络情况调整，一般2-5秒足够。
   
   

3. 手动注入MathJax脚本到HTMLwidget
   如果上述方法无效，可直接给Plotly对象添加MathJax加载脚本，确保截图环境能识别LaTeX：

   library(htmlwidgets)
   # 注入MathJax v3的加载脚本
   p_with_mathjax <- prependContent(
     p,
     tags$script(src = "https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js")
   )
   

4. 调整R Markdown的PDF输出配置
   在YAML头部设置self_contained: false，允许文档加载外部CDN资源：

   ---
   title: "Plotly LaTeX PDF Test"
   output:
     pdf_document:
       self_contained: false
   ---
   

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