Jupyter Notebook中myst_nb glue变量无法渲染问题求助

可能的变化点及对应解决方案 #

1. myst_nb版本更新导致语法变更 #

旧版myst_nb支持{{results}}这类简洁语法，但v0.13及以上的新版本已切换为MyST指令式语法，需改用以下格式：

• 普通文本引用：{glue:text}results``
• 数值格式化引用：{glue:num}results``
• 直接插入原始内容：{glue:}results``

示例：
My calculation of the 5x5 gave the result of {glue:text}results.

2. 代码单元格未执行或变量未正确注册 #

确保包含glue调用的代码单元格已运行，可通过添加display=True验证变量是否生成：

from myst_nb import glue 

a = 5*5
# 验证变量是否成功注册并显示
glue("results", a, display=True)

执行后若直接输出25，说明变量已正确绑定。

3. 渲染环境未启用MyST解析 #

• 若使用Jupyter Book构建，需在_config.yml中确保启用myst_nb扩展：

sphinx:
  config:
    extensions:
      - myst_nb

• 若在Jupyter Lab中预览，需安装并启用myst_nb的Lab扩展：

pip install myst-nb
jupyter labextension install @myst-nb/jupyterlab

同时要确保Markdown单元格的格式设置为MyST Markdown（而非默认的普通Markdown）。

4. 变量名或语法错误 #

检查：

• 变量名是否与glue调用的名称完全一致（大小写敏感）
• 引用语法的符号是否正确配对（如反引号、花括号）

内容的提问来源于stack exchange，提问作者Jo-Achna