为Quarto文档添加页码与行号的解决方案咨询

直接通过YAML配置添加页码 #

无需修改参考文档，直接在Quarto文档的YAML头部添加页脚配置，利用Quarto内置变量生成动态页码：

format:
  docx:
    footer: |
      <p style="text-align:center;">第 <span style="font-variant-numeric: tabular-nums;">{page-number}</span> 页，共 <span style="font-variant-numeric: tabular-nums;">{total-pages}</span> 页</p>

• {page-number} 渲染为当前页码，{total-pages} 渲染为总页数
• 用HTML标签可调整页脚对齐方式、字体样式，上述配置实现居中对齐的页码效果

修复参考文档不生效的问题 #

若之前修改参考文档无效果，大概率是生成或配置步骤有误，正确流程如下：

1. 导出Quarto默认docx参考文档，在终端执行：

   quarto pandoc -o default-reference.docx --print-default-data-file reference.docx
   

2. 用Microsoft Word打开导出的default-reference.docx，进入页脚编辑模式：
   • 插入页码，设置好位置（如居中、居右）、格式（如阿拉伯数字、带总页数）
   • 保存修改后的文档为custom-reference.docx
3. 在Quarto文档的YAML中指定自定义参考文档：

   format:
     docx:
       reference-doc: custom-reference.docx
   

• 注意参考文档路径要正确，与Quarto文档同目录时直接写文件名即可，否则需填写相对/绝对路径

添加行号 #

行号可通过YAML直接配置，也可在参考文档中预设：

YAML配置方式 #

format:
  docx:
    line-numbers: true
    line-number-start: 1  # 设置行号起始值
    line-number-step: 1   # 设置行号递增步长

参考文档配置方式 #

打开自定义参考文档，点击Word「布局」选项卡，找到「行号」按钮，选择所需样式（如连续、每页重新编号），保存后Quarto渲染时会自动继承该设置

常见注意事项 #

• 确保使用最新版Quarto，旧版本可能不支持部分页脚变量或行号配置
• 若同时设置YAML的footer参数和参考文档页脚，footer配置会覆盖参考文档设置，建议仅选一种方式
• 页脚中的HTML样式仅支持Word兼容的简单标签，复杂样式建议直接在参考文档中设置

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