Markdig项目：如何获取Markdown标题自动生成的锚点ID列表

在Markdig这个强大的Markdown解析库中，标题元素会被自动转换为带有ID属性的HTML标签，这个特性对于文档内部跳转和目录生成非常有用。本文将详细介绍如何获取这些自动生成的锚点ID列表。

自动ID生成机制

Markdig会为每个标题块(HeadingBlock)自动生成唯一的ID属性，其规则如下：

1. 对于中文标题：会生成"section"为前缀的ID，如"section"、"section-1"
2. 对于英文标题：会将标题文本转换为小写并用连字符连接，如"hello-world"
3. 遇到重复ID时会自动添加数字后缀

获取ID列表的方法

通过Markdig提供的API，我们可以轻松获取所有标题的ID列表：

// 创建Markdig解析管道
var pipeline = new MarkdownPipelineBuilder().Build();

// 解析Markdown内容
MarkdownDocument document = Markdown.Parse(content, pipeline);

// 遍历所有标题块并获取ID
foreach (HeadingBlock heading in document.Descendants<HeadingBlock>())
{
    string id = heading.GetAttributes().Id;
    // 处理获取到的ID
}

// 生成HTML
string html = document.ToHtml(pipeline);

实际应用场景

1. 自动生成目录：通过获取所有标题的ID和文本，可以构建文档导航
2. 内部链接验证：检查文档内的跳转链接是否有效
3. 文档分析：统计文档结构信息

注意事项

1. ID生成规则可能会随Markdig版本变化
2. 中文和英文标题的ID生成方式不同
3. 可以通过自定义管道修改ID生成策略

掌握这个技巧可以让你更好地利用Markdig构建复杂的文档处理系统，特别是在需要与标题锚点交互的场景下。