Jupyter Lab中MyST扩展无法渲染，如何启用？

一、Jupyter Lab 4.4.7 配置 #

1. 安装Jupyter Lab专用MyST扩展
   用mamba或pip安装jupyterlab-myst，这是Lab中渲染MyST语法的核心扩展：

   mamba install -c conda-forge jupyterlab-myst
   # 或用pip安装
   pip install jupyterlab-myst
   

   安装完成后重启Jupyter Lab，:::{note}这类围栏语法即可正常渲染。

2. 启用公式编号与引用
   在Markdown单元格中使用MyST专属公式语法：

   • 定义带编号的公式：

     $$
     E = mc^2 \label{eq:emc2}
     $$
     

   • 引用公式：

     如公式 {eq}`eq:emc2` 所示...
     

   安装上述扩展后，Lab默认启用MyST公式支持，无需额外手动开启。

二、Jupyter Book 配置 #

1. 确认核心依赖
   除已安装的myst-parser，需确保jupyter-book已安装：

   mamba install -c conda-forge jupyter-book
   

2. 修改项目配置文件_config.yml
   在Jupyter Book项目根目录的_config.yml中添加以下配置：

   # 指定用MyST解析器
   parser: myst-parser
   
   # 启用必要的MyST扩展
   myst_enable_extensions:
     - amsmath          # 支持LaTeX公式语法
     - colon_fence      # 支持:::类型的围栏块
     - dollarmath       # 兼容$和$$公式写法
     - equation_numbering # 开启公式自动编号
   
   # 配置全局公式自动编号规则
   sphinx:
     config:
       mathjax_config:
         TeX:
           equationNumbers:
             autoNumber: all
   

3. 重新构建Book
   执行构建命令使配置生效：

   jupyter-book build your_book_directory/
   

验证效果 #

• 在Jupyter Lab中新建Markdown单元格，测试:::{note}块和公式引用，刷新页面查看渲染结果。
• 在Jupyter Book项目中添加测试内容后重新构建，检查生成的HTML/PDF中MyST元素是否正常显示。

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