在Jupyter Notebook中用Quarto生成PDF时，如何便捷格式化长图表标题？

方法1：代码注释内原生换行 #

Quarto支持代码单元格注释的多行拼接，直接拆分长标题为多行注释，无需额外转义符，Quarto会自动合并为完整标题。示例：

#| tbl-cap: Counts for All Trades Data with Non-Missing `TRADE_VAR` by Asset and Transaction Types.
#|   This includes cross-asset comparisons across equities, fixed income, and derivative products,
#|   with transaction type breakdowns covering market orders, limit orders, stop-loss orders,
#|   and algorithmic execution strategies. The dataset excludes records where `TRADE_VAR` is missing,
#|   ensuring consistency in volume and price metric calculations for subsequent regression analysis.

注意：第二行及以后的注释开头需加空格缩进，Quarto会识别为同一标题的延续，输出PDF时标题会自动排版为合适的换行，不影响最终显示效果。

方法2：用Notebook变量存储长标题 #

若希望标题与代码逻辑分离，可在单独代码单元格定义标题变量，再通过Quarto的!expr语法调用：

1. 单独单元格定义标题变量：

long_table_caption = """Counts for All Trades Data with Non-Missing `TRADE_VAR` by Asset and Transaction Types.
This includes cross-asset comparisons across equities, fixed income, and derivative products,
with transaction type breakdowns covering market orders, limit orders, stop-loss orders,
and algorithmic execution strategies. The dataset excludes records where `TRADE_VAR` is missing,
ensuring consistency in volume and price metric calculations for subsequent regression analysis."""

2. 生成表格的代码单元格调用变量：

#| tbl-cap: !expr long_table_caption
# 表格生成代码示例：
import pandas as pd
trade_data = pd.read_csv("trades.csv")
summary_table = trade_data.dropna(subset=["TRADE_VAR"]).groupby(["ASSET_TYPE", "TRANSACTION_TYPE"]).size().reset_index(name="COUNT")
summary_table

这种方式既可以在Notebook里用多行字符串清晰编辑长标题，又能保持代码单元格整洁，Quarto会自动解析变量内容作为标题。

方法3：用Quarto单元格选项块（适配超长篇幅标题） #

如果标题超过300词，可使用Quarto的单元格选项块，将标题完全与代码分离：

:::{cell-options}
tbl-cap: >
  Counts for All Trades Data with Non-Missing `TRADE_VAR` by Asset and Transaction Types.
  This includes cross-asset comparisons across equities, fixed income, and derivative products,
  with transaction type breakdowns covering market orders, limit orders, stop-loss orders,
  and algorithmic execution strategies. The dataset excludes records where `TRADE_VAR` is missing,
  ensuring consistency in volume and price metric calculations for subsequent regression analysis.
:::

在该块下方的代码单元格编写表格生成逻辑即可，无需再添加#| tbl-cap注释。这种方式最适合学术场景下的超长篇幅图表标题，编辑时无需在代码中横向滚动。

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