如何在Quarto中正确插入矩阵并渲染为docx格式？

API 探路者

2026-7-7

Quarto中渲染矩阵到DOCX的解决方法

放弃你看到的\matrix(@&&)语法，Quarto默认支持标准LaTeX数学环境，用LaTeX原生矩阵写法更可靠：
- 行内公式（嵌入文本）：
```
$a = \begin{pmatrix} 2 & 1 & 5 \\ 6 & 7 & 9 \\ 8 & 3 & 0 \end{pmatrix}$
```
- 块级公式（单独成行）：
```
$$
a = \begin{pmatrix}
    2 & 1 & 5 \\
    6 & 7 & 9 \\
    8 & 3 & 0
\end{pmatrix}
$$
```
  其中\\用于分隔矩阵行，&用于分隔列；\begin{pmatrix}会生成带圆括号的矩阵，若要方括号可替换为\begin{bmatrix}。
配置DOCX输出的YAML头部：
在你的.qmd文件开头添加以下配置，明确指定输出格式为DOCX：
```
---
title: "矩阵渲染测试"
format: docx
---
```
执行渲染：
用命令行运行quarto render your-file.qmd，或在编辑器（如RStudio、VS Code）中直接预览/导出，生成的DOCX文件会自动将LaTeX矩阵转换为Office MathML格式，完美显示矩阵结构。