Module heading 

标题：层级映射、锚点 slug 与目录（TOC）HTML。

Functions

escape_heading_text 🔒

将标题纯文本转义，用于安全地拼进 TOC 的 aria-label="..." 与 <a> 正文。

generate_toc_html 🔒

根据标题层级生成嵌套目录 HTML。

heading_level 🔒

Markdown 标题层级转数字（H1 → 1 … H6 → 6），供 TOC 层级比较。

heading_tag 🔒

根据 Markdown 标题层级返回对应的 HTML 标签名。

slugify_heading 🔒

将标题文本转换为可用于锚点的 slug。

unique_heading_slug 🔒

在同一篇文档内为标题分配唯一锚点：首次出现保留 slugify_heading 的结果， 重复时依次追加 -1、-2…（与 GitHub 一致）；候选已被其他标题占用 （如另有标题恰为 Foo 1）时继续递增，保证 TOC 链接一一对应。