如何阻止 docfx 在 c# xml 注释中将“\\”转义为“\”？

Question

我正在创建一些包含 LaTeX 样式矩阵符号的 XML 注释。使用 docfx 创建文档时，通常表示矩阵中新行的 \\ 字符将转换为 \.

有什么办法可以防止这种情况发生吗？

///<summary>
/// Blah
///</summary>
/// \f[ \left(\begin{matrix} 0 &amp; 1 &amp; 2 \ 3 &amp; 4 &amp; 5 \end{matrix}\right) \f]
public void Method()
{

}

输出：

<p>\f[ \left(\begin{matrix} 0 &amp; 1 &amp; 2 \ 3 &amp; 4 &amp; 5 \end{matrix}\right) \f]</p>

Answer 1

要阻止 docfx 处理 XML 评论的内容，请指示跳过 docfx.json 文件的元数据部分中的标记：

"metadata": [
    {
      <src etc>,
      "shouldSkipMarkup":true
    }
  ]

如何阻止 docfx 在 c# xml 注释中将“\\”转义为“\”？

How to stop docfx from escaping "\\" to "\" in c# xml comments?

c#

docfx