c# - 如何阻止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
    }
  ]