如何在非LaTeX、MS Word或HTML输出的Quarto文档中创建缩写列表？

手动构建缩写列表（通用方案） #

这类输出格式大多不支持Quarto原生的缩写扩展，最稳妥的方式是手动创建：

• 在文档开头、结尾或附录位置添加标题，比如## 缩写列表
• 用无序列表或表格呈现缩写与全称，示例如下：
  无序列表形式：

  ## 缩写列表
  - API：应用程序编程接口（Application Programming Interface）
  - URL：统一资源定位符（Uniform Resource Locator）
  

  表格形式（更规整）：

  ## 缩写列表
  | 缩写 | 全称 |
  |------|------|
  | API | 应用程序编程接口（Application Programming Interface） |
  | URL | 统一资源定位符（Uniform Resource Locator） |
  

• 正文里首次出现缩写时手动标注全称，后续直接用缩写即可。

借助Quarto变量实现半自动化（有限支持） #

如果想减少重复工作量，可以利用Quarto的变量定义功能：

1. 在文档开头的YAML区域定义缩写变量：

   ---
   title: "示例文档"
   abbreviations:
     api: "应用程序编程接口（API）"
     url: "统一资源定位符（URL）"
   ---
   

2. 正文中首次引用时调用变量：{{< meta abbreviations.api >}}，后续直接写缩写。比如：

   本文中提到的{{< meta abbreviations.api >}}是现代软件开发的核心组件，后续我们会多次提及API的应用场景。
   

3. 在缩写列表区域，通过遍历变量自动生成列表（注意：部分小众格式可能不支持该渲染逻辑，建议提前测试）：

   ## 缩写列表
   {{ range $key, $value := .Params.abbreviations }}
   - {{ $key | upper }}: {{ $value | replaceRE "\\((.*?)\\)" "" | trim }}
   {{ end }}
   

脚本预处理生成列表（批量场景） #

如果需要频繁处理这类格式，可以写简单脚本（比如Python）：

• 脚本扫描文档内容，提取所有缩写和对应的全称
• 自动生成标准化的缩写列表，插入到文档指定位置后，再用Quarto编译为目标格式

内容的提问来源于stack exchange，提问作者Nicolás Sacco