Markdig项目中PipeTable解析器边界字符丢失问题分析

在Markdig这个强大的Markdown解析库中，PipeTable扩展模块存在一个边界字符丢失的问题。这个问题表现为当解析管道表格(Pipe Table)时，表格的起始和结束字符(|)会被意外丢弃。

问题现象

当使用Markdig解析如下Markdown表格时：

| Attributes               | Details                                           |
|:---                      |:---                                               |
| `<docs-card-container>`  | All cards must be nested inside a container       |
| `title`                  | Card title                                        |
| card body contents       | Anything between `<docs-card>` and `</docs-card>` |
| `link`                   | (Optional) Call to Action link text               |
| `href`                   | (Optional) Call to Action link href               |

解析后的结果会丢失表格最左侧和最右侧的管道符号(|)。这个问题在提取原始文本时尤为明显，因为Span属性没有正确包含这些边界字符。

技术背景

Markdig中的表格解析分为两种主要类型：

1. GridTable(网格表格)：使用+和-字符构建表格边框
2. PipeTable(管道表格)：使用|字符分隔列

PipeTable的解析实现相对复杂，因为它需要处理以下特殊情况：

• 表格可能出现在段落中间
• 管道符号可能被转义
• 需要区分表格和列表项(以-开头)

问题根源

经过分析，这个问题源于PipeTable解析器的特殊设计。由于表格检测是在段落解析之后进行的，解析器需要将已解析的段落内容重新组织为表格结构。在这个过程中，边界字符的位置信息没有被正确保留。

与GridTable不同，PipeTable使用InlineParser而非BlockParser，这使得它的解析流程更加复杂。解析器需要处理原始文本中的管道符号作为分隔符，同时保留这些符号的位置信息。

临时解决方案

目前可以通过调整Span范围来临时解决这个问题：

public static string ExtractText(string text, Block item)
{
    var start = item.Span.Start;
    var len = item.Span.Length;

    if (item is Table)
    {
        start--;
        len += 2;
    }

    return text.Substring(start, len);
}

长期解决方案建议

要彻底解决这个问题，需要在PipeTableParser中修正Span的计算方式，确保：

1. 包含表格起始的管道符号
2. 包含表格结束的管道符号
3. 正确处理多行表格的边界情况

这个问题虽然不影响表格的结构化数据提取，但在需要精确还原原始Markdown文本的场景下会造成困扰。建议在后续版本中修正Span计算逻辑，确保位置信息的准确性。