Jupyter Book中MyST代码块多行高亮功能异常解析

在Jupyter Book项目的使用过程中，开发者发现了一个关于MyST代码块高亮功能的异常现象。该问题表现为当用户尝试通过范围语法（如:emphasize-lines: 30-31）高亮多行代码时，高亮效果未能正常显示，而改用逗号分隔的离散语法（如:emphasize-lines: 30,31）时则能正常工作。

技术背景
MyST（Markedly Structured Text）是Jupyter Book项目使用的标记语言扩展，它基于CommonMark规范并添加了科学计算文档所需的特殊功能。其中代码块高亮功能是通过解析:emphasize-lines:指令实现的，该指令理论上应支持两种语法格式：

1. 范围语法：用连字符表示连续行号区间（如10-15）
2. 离散语法：用逗号分隔独立行号（如2,5,8）

问题本质
经过技术团队分析，该问题源于范围语法解析器的实现缺陷。在底层解析逻辑中，对连字符分隔符的处理存在边界条件未覆盖的情况，导致行号区间无法正确转换为离散的行号集合。相比之下，离散语法由于直接处理明确的行号列表，因此不受此影响。

影响范围
该问题会影响所有使用Jupyter Book v2.0.0a3版本的用户，特别是在以下场景：

• 需要突出显示连续多行代码的教学文档
• 需要标注大段代码修改痕迹的技术文档
• 自动化生成的包含行号标注的文档

解决方案
项目团队已通过提交修复了该问题，主要改进包括：

1. 重写行号范围解析算法，确保正确处理各种边界情况
2. 增加测试用例覆盖所有可能的行号表示形式
3. 优化错误处理机制，对非法格式提供明确警告

用户建议
对于暂时无法升级版本的用户，可采用以下临时解决方案：

• 使用逗号分隔的离散语法替代范围语法
• 手动计算连续行号并展开为离散列表
• 通过CSS自定义类实现类似高亮效果

该修复体现了开源社区对文档工具链稳定性的持续改进，建议用户关注后续版本更新以获取更完整的功能体验。