将Flextable作为参数传入quarto_render()时无法正确渲染

问题核心：通过quarto_render()的execute_params传递flextable对象时，Quarto/knitr未触发其专属的渲染逻辑，而是默认打印了对象的底层列表结构，导致输出大量无效内容。

解决方案一：传递数据框而非flextable对象（推荐） #

这种方法避免复杂对象序列化的潜在问题，稳定性更高：

1. 修改Quarto文档的参数定义：

---
title: "Flextable test"
author: "Dave"
format: docx
editor: visual
params:
  my_table_data: "missing"  # 改为接收数据框
---

2. 在Quarto文档中生成flextable：

{r libraries}
library(flextable)

{r fixed-table}
#| tbl-cap: "fixed-table"
flextable(params[["my_table_data"]])

3. 修改调用代码，传递原始数据框：

library(quarto)
library(flextable)

quarto_render(input = "R/flextable-test.qmd",
              execute_params = list(my_table_data = mtcars))

解决方案二：强制转换flextable为可渲染的R Markdown代码 #

若必须传递flextable对象，可通过flextable_to_rmd()将其转换为Quarto可识别的代码片段：

1. 保持Quarto文档的参数定义不变，修改对应代码块：

{r fixed-table, results='asis'}
#| tbl-cap: "fixed-table"
library(flextable)
cat(flextable_to_rmd(params[["my_flextable"]]))

2. 调用代码保持原逻辑即可：

library(quarto)
library(flextable)

a_flextable <- flextable(mtcars)

quarto_render(input = "R/flextable-test.qmd",
              execute_params = list(my_flextable = a_flextable))

原因说明 #

通过execute_params传递复杂对象时，Quarto的参数序列化/反序列化过程可能丢失flextable的元数据，导致knitr无法识别其类型，进而触发默认的列表打印行为。方案一绕过了复杂对象传递的问题，方案二则直接生成Quarto可解析的表格渲染代码，强制输出正确格式。

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