如何在Plotly数学模式文本中设置换行？

问题概述 #

在Plotly的数学模式文本中设置换行时，多种尝试方案均失效：

• 使用$\alpha \\ \beta$会触发to_image报错
• 使用r"$\alpha \\ \beta$"、"$\\alpha \\\\ \\beta$"、"$$\\alpha \\\\ \\beta$$"时，α与β之间无换行效果
• 使用"$\\alpha$<br>$\\beta$"或"$$\\alpha$$ <br> $$\\beta$$"时，仅显示α，β完全不渲染

尝试的测试代码如下：

import plotly.graph_objects as go

fig = go.Figure()
fig.add_trace(go.Box(y=[10, 14]))

fig.update_layout(xaxis_title="$\alpha \\ \beta$") # 导致to_image报错
# fig.update_layout(xaxis_title=r"$\alpha \\ \beta$") # α和β的数学符号间无换行
# fig.update_layout(xaxis_title="$\\alpha$<br>$\\beta$") # 仅显示α的数学符号，完全不显示β！
# fig.update_layout(xaxis_title="$\\alpha \\\\ \\beta$") # α和β的数学符号间无换行
# fig.update_layout(xaxis_title="$$\\alpha \\\\ \\beta$$") # α和β的数学符号间无换行
# fig.update_layout(xaxis_title="$$\\alpha$$ &lt;br&gt; $$\\beta$$") # 仅显示α的数学符号，完全不显示β！

fig.show()
fig.write_image("this_image.pdf")

可行解决方案 #

Plotly的数学模式基于LaTeX解析，需用LaTeX原生多行排版语法实现换行，以下两种方案可解决问题：

方案1：使用LaTeX array环境 #

利用LaTeX的array环境构建多行数学文本，注意字符串中转义规则：

import plotly.graph_objects as go

fig = go.Figure()
fig.add_trace(go.Box(y=[10, 14]))

# 用array环境实现居中换行，双反斜杠完成转义
fig.update_layout(xaxis_title=r"$\begin{array}{c} \alpha \\ \beta \end{array}$")

fig.show()
fig.write_image("this_image.pdf")

其中{c}表示内容居中对齐，可根据需求替换为{l}（左对齐）或{r}（右对齐）。

方案2：结合HTML换行与独立数学块（非轴标题场景） #

如果是数据标签等非轴标题元素，可将每个数学符号单独用$包裹，搭配HTML的<br>实现换行：

import plotly.graph_objects as go

fig = go.Figure(go.Box(
    y=[10,14],
    text=["$\\alpha$<br>$\\beta$"],
    texttemplate="%{text}",
    textposition="inside"
))

fig.update_layout(xaxis_title=r"$\begin{array}{c} \alpha \\ \beta \end{array}$")

fig.show()
fig.write_image("this_image.pdf")

原理说明 #

Plotly的数学模式优先解析LaTeX语法，HTML的<br>会被LaTeX忽略；单独的\\在字符串中转义后无法被LaTeX识别为换行指令。而array是LaTeX原生的多行排版工具，能被Plotly的渲染器正确解析，同时不会触发导出图片报错。

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