使用Markdig转换含LaTeX公式的Markdown失败问题排查

问题根源 #

Markdig默认的Markdown解析逻辑会将反斜杠视为Markdown转义字符，因此\[会被解析为普通的[，LaTeX语法中的转义反斜杠（比如\text、\,）也会被消耗，最终导致公式失效。

正确解决方案 #

使用Markdig官方提供的数学公式扩展，无需手动修改原始字符串中的反斜杠：

1. 安装NuGet包
   先安装支持LaTeX的扩展包：

   Install-Package Markdig.Extensions.Mathematics
   

2. 修改代码启用扩展
   在构建MarkdownPipeline时启用数学公式支持：

   string original = "A **formula** from chatGPT:\\[\\frac{7 \\, \\text{J} - 4 \\text{ N}}{3 \\text{ m}^2}\\]";
   var pipeline = new MarkdownPipelineBuilder()
       .UseMathematics() // 启用LaTeX公式解析
       .Build();
   string html = Markdown.ToHtml(original, pipeline);
   

效果说明 #

启用UseMathematics()后，Markdig会自动识别\[...\]包裹的块级LaTeX公式，不会解析其中的反斜杠为Markdown转义符，而是完整保留给LaTeX使用。转换后的HTML会将公式部分包裹在带有math block类的标签中，后续可以通过MathJax或KaTeX等库完成公式渲染。

不推荐手动加倍反斜杠的原因 #

手动加倍反斜杠需要覆盖所有可能的转义场景，容易遗漏且代码可维护性差，官方扩展能更可靠地处理所有LaTeX语法的转义需求。

内容的提问来源于stack exchange，提问作者Qrt