带有降价注释的ASP.NET Web API帮助页面

Question

我使用asp.net WebApi帮助页面从源代码的注释生成文档。 而且我以前曾使用doxygen生成文档。 doxygen可以解析注释中的markdown语法并输出格式正确的文档。 但是， WebApi帮助页面现在无法解析markdown语法。

例如， foo函数的注释包含Markdown注释 ，它将作为### Markdown comments *It will return "foo" *It always returns "foo"输出### Markdown comments *It will return "foo" *It always returns "foo"在WebApi帮助页面中 ### Markdown comments *It will return "foo" *It always returns "foo" 。

public MyApiController : ApiController {
     ///<summary>
     /// It will return "foo"
     /// ### Markdown comments
     /// * It will return "foo"
     /// * It always returns "foo"
     ///</summary>    
     [HttpPost, ActionName("foo")]
     public string Foo() {
         return "foo";
     }
}

Answer 1

感谢您的提示，刚刚修改了HelpPageApiModel.cshtml

1）从NuGet安装一些Markdown库，例如MarkdownDeep

2）添加助手功能。 请注意，您应该修剪行，因为<summery>会按原样解析，并且在换行符之后的所有尾随空格都将被解析。 否则，所有降价清单等都将无法正确解析。

@functions {
    string ToMarkdown(string str)
    {
        var lines = str.Split('\n');
        var whitespaceCount = 0;
        var i = 0; //from 2. Line
        var imax = lines.Count();
        while (++i < imax)
        {
            var line = lines[i];
            if (whitespaceCount != 0)
            {
                lines[i] = line.Substring(whitespaceCount);
                continue;
            }
            var trimmed = line.TrimStart();
            if (trimmed.Length == 0 || trimmed == line) continue;
            whitespaceCount = line.Length - trimmed.Length;
            i--;
        }
        str = string.Join("\n", lines);
        var md = new MarkdownDeep.Markdown {ExtraMode = true, SafeMode = false};
        return md.Transform(str);
    }
}

3）预处理文档字符串输出

<p>@Html.Raw(ToMarkdown(description.Documentation))</p>