如何以程序化方式在R Markdown文档中嵌入targets工作流的静态图像？

针对你在R Markdown中嵌入targets工作流静态图的需求，这里有几个无需手动操作的程序化方案，完美适配Pandoc渲染HTML的场景：

方案1：用DiagrammeR直接渲染mermaid代码为静态图 #

tar_mermaid()生成的mermaid文本可以通过DiagrammeR包直接渲染并导出为SVG/PNG格式，这是最直接的解决方案：

1. 安装依赖包：

install.packages(c("DiagrammeR", "targets"))

2. 生成并导出静态图：

library(targets)
library(DiagrammeR)

# 生成targets工作流的mermaid代码
mm <- tar_mermaid()

# 渲染为可视化图形对象
workflow_diagram <- mermaid(mm)

# 导出为SVG（矢量图，清晰度更高）
export_graph(workflow_diagram, file_name = "target_workflow.svg", file_type = "svg")

# 或者导出为PNG
export_graph(workflow_diagram, file_name = "target_workflow.png", file_type = "png")

3. 在R Markdown中插入图片：

![Targets工作流图](target_workflow.png)

这样Pandoc渲染HTML时就能直接显示静态图，完全不需要手动操作。

方案2：让Pandoc直接渲染R Markdown中的mermaid代码块 #

如果你偏好直接在Markdown中写mermaid代码，确保你的Pandoc版本≥2.16（新版本内置了mermaid支持），可以通过以下方式配置：

1. 在R Markdown的YAML头部添加配置：

output:
  html_document:
    md_extensions: +fenced_code_attributes

2. 在R代码块中生成mermaid代码并输出为asis格式：

```{r, results='asis'}
library(targets)
cat("```mermaid\n")
cat(tar_mermaid(), "\n")
cat("```\n")

这样Pandoc会自动识别mermaid代码块并渲染为图形，无需额外工具。

## 方案3：基于visNetwork生成静态图
如果你更习惯用`tar_visnetwork()`的交互图，可以通过`htmlwidgets`和`webshot`将其转换为静态PNG：

1. 安装依赖包：
```r
install.packages(c("htmlwidgets", "webshot", "targets"))
webshot::install_phantomjs() # 需要安装PhantomJS作为渲染引擎

2. 程序化转换：

library(targets)
library(htmlwidgets)
library(webshot)

# 生成visNetwork交互部件
vis_widget <- tar_visnetwork()

# 保存为临时HTML文件
saveWidget(vis_widget, "temp_workflow.html", selfcontained = TRUE)

# 将HTML转换为PNG
webshot("temp_workflow.html", "target_workflow.png", vwidth = 1000, vheight = 700)

# 清理临时文件
file.remove("temp_workflow.html")

注意事项 #

• DiagrammeR的mermaid渲染效果和mermaid.live略有差异，但核心的工作流结构完全一致；
• 如果使用方案2，确保你的Pandoc版本足够新，旧版本可能需要额外安装mermaid Lua过滤器；
• 方案3需要PhantomJS支持，适合需要保留visNetwork样式的场景。

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