Python-Markdown扩展优先级问题：TOC与Smarty的冲突解析

在Python-Markdown项目中，当同时启用TOC（目录生成）和Smarty（智能标点转换）扩展时，开发者可能会遇到一个微妙但重要的问题：Smarty扩展对标题文本的转换效果不会反映在最终生成的目录条目中。

问题现象

当用户同时启用这两个扩展并处理包含特殊标记的标题时，例如：

md = markdown.Markdown(extensions=['toc', 'smarty'])
md.convert('# *Foo* --- `bar`')

虽然HTML输出会正确显示Smarty转换后的结果（将---转换为—），但目录数据结构中的标题文本却保留了原始形式，没有经过Smarty处理。

技术原因

这个问题的根源在于两个扩展的Treeprocessor执行优先级：

1. TOC扩展默认优先级为500
2. Smarty扩展默认优先级为1（最低优先级）

在Markdown处理流程中，TOC扩展会先于Smarty扩展执行，导致它捕获的是未经Smarty处理的原始标题文本。

解决方案

经过项目维护者的讨论和测试，确认可以安全地调整Smarty扩展的优先级，使其在TOC扩展之前执行。具体修改方案包括：

1. 将Smarty扩展的Treeprocessor优先级从1提高到5
2. 确保这个修改不会影响其他扩展的正常工作

这种调整方式既解决了问题，又保持了向后兼容性，不会影响现有依赖TOC扩展优先级的代码。

技术启示

这个案例给我们几个重要的技术启示：

1. 扩展优先级的重要性：在Markdown处理流程中，扩展的执行顺序直接影响最终结果
2. 兼容性考量：修改现有扩展优先级时需要谨慎评估对现有用户的影响
3. 测试验证：任何优先级调整都需要通过全面的测试来验证不会引入回归问题

对于Markdown扩展开发者来说，这个案例也提醒我们需要：

• 仔细考虑扩展的默认优先级设置
• 在文档中明确说明扩展的执行顺序依赖
• 提供配置选项让用户可以调整优先级

通过理解这个问题的本质和解决方案，开发者可以更好地在Python-Markdown项目中组合使用各种扩展，实现预期的文档处理效果。