Python-Markdown扩展优先级问题：TOC与Smarty的标题处理冲突

在Python-Markdown项目中，当同时启用TOC（目录生成）和Smarty（智能标点转换）两个扩展时，开发者发现了一个值得注意的优先级处理问题。这个问题影响了标题文本在目录中的最终呈现形式。

问题现象

当用户同时使用TOC和Smarty扩展时，Smarty扩展对标题文本的智能转换（如将---转换为破折号—）不会反映在最终生成的目录条目中。例如，对于标题# *Foo* --- bar``，HTML输出会正确显示为<h1 id="foo-bar"><em>Foo</em> &mdash; <code>bar</code></h1>，但目录条目中的名称却保留了原始文本形式Foo --- bar，没有进行智能标点转换。

技术原因分析

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

1. TOC扩展的Treeprocessor优先级较高（默认值为5）
2. Smarty扩展的Treeprocessor优先级较低（默认值为1）

在文档处理流程中，TOC扩展会先于Smarty扩展执行。当TOC扩展收集标题文本生成目录时，Smarty扩展尚未对文本进行智能标点转换，导致目录中保留了原始文本形式。

解决方案

经过项目维护者的讨论和测试，确认可以通过调整Smarty扩展的优先级来解决这个问题。将Smarty扩展的Treeprocessor优先级提高到高于TOC扩展的值（如6），可以确保智能标点转换先于目录生成执行。

这种调整方案具有以下优势：

1. 保持向后兼容性，不影响现有功能
2. 不需要修改TOC扩展的优先级，避免影响依赖当前优先级的现有实现
3. 符合逻辑处理顺序：先进行文本转换，再生成目录

最佳实践建议

对于扩展开发者而言，这个案例提供了重要启示：

1. 在设计Markdown扩展时，需要仔细考虑处理优先级
2. 与文本转换相关的扩展通常应该具有较高的优先级
3. 在文档处理流程中，内容转换应该先于内容收集和分析

对于使用者而言，如果遇到类似问题，可以：

1. 检查相关扩展的优先级设置
2. 考虑调整扩展加载顺序
3. 必要时自定义扩展优先级

这个问题虽然看似简单，但它揭示了Markdown处理流程中扩展优先级设计的重要性，也为处理类似问题提供了参考方案。