pdoc项目增强：支持HTML标题在目录中的自动识别

在文档生成工具pdoc的使用过程中，开发者发现当文档字符串包含HTML标题标签（如<h1>）时，这些标题无法被自动识别并包含在生成的目录（ToC）中。这种情况常见于通过.. include::指令引入的外部HTML文件或混合使用Markdown与HTML标题的文档场景。

pdoc底层依赖的markdown2库其实已经提供了相关功能支持。具体而言，通过启用header-ids扩展的mixed模式，即可实现对HTML标题的自动识别和ID生成。这一功能在markdown2的更新中已经实现，但pdoc尚未默认启用该配置。

技术实现上，只需要在pdoc的渲染配置中简单调整header-ids参数即可：

"header-ids": {
    "mixed": True  # 启用混合模式识别HTML标题
}

这一改进具有以下技术优势：

1. 保持与现有markdown2功能的兼容性
2. 无需增加新的命令行参数，符合项目保持简洁接口的设计理念
3. 对使用者完全透明，不改变现有工作流程
4. 解决了混合格式文档的目录生成问题

对于文档编写者而言，这意味着可以更灵活地组织文档内容：

• 可以直接引入包含HTML标题的外部文档片段
• 支持历史遗留的混合格式文档
• 保持生成的目录结构完整性

该改进已被项目维护者采纳并合并，体现了pdoc项目对实用性和兼容性的持续优化。对于需要处理复杂文档结构的Python项目，这一增强显著提升了文档工具的适应能力。