Quarto+RStudio用officedown生成docx失败，输出为html求助

核心原因 #

你混淆了Quarto和R Markdown的YAML配置语法：

• Quarto使用format:字段定义输出格式，而output:是R Markdown专属的配置项，Quarto中使用output:会被忽略，默认生成HTML文件。
• officedown::rdocx_document是R Markdown的输出格式，不能直接套用到Quarto的配置里。

另外你最初用format: docx生成带图片的flextable时docx打不开，本质是Quarto默认的docx渲染逻辑对flextable内嵌图片的支持有问题，需要借助officedown来处理，但得用Quarto兼容的配置方式。

解决办法 #

改用Quarto标准的format:配置，指定docx格式并启用knitr引擎（officedown依赖knitr的渲染逻辑），完整配置和代码如下：

正确的YAML配置 #

---
date: "`r Sys.Date()`"
author: "Your Name"
title: "Untitled"
format:
  docx:
    engine: knitr
    echo: true
---

完整代码块 #

{r setup, include=FALSE}
library(officedown)
library(flextable)
library(officer)
knitr::opts_chunk$set(fig.cap = TRUE)

{r}
img.file <- file.path(R.home("doc"), "html", "logo.jpg")

myft <- flextable(head(iris))

myft <- compose(
  myft, i = 1:3, j = 1,
  value = as_paragraph(
    as_image(src = img.file, width = .20, height = .15),
    " blah blah ",
    as_chunk(Sepal.Length, props = fp_text(color = "red"))
  ),
  part = "body"
)

autofit(myft)

额外注意事项 #

• 如果仍有兼容性问题，建议更新flextable、officedown、officer到最新版本。
• 可以在docx配置中添加reference-doc: 你的模板文件.docx，用自定义Word模板保证格式兼容性。

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