ASP.NET Core中间件Markdown转换器

目录

需求

文本编码检测

Markdown→HTML

注意

实现


需求

  1. Markdown是一种文本格式;不被浏览器支持;编写一个在服务器端把Markdown转换为HTML的中间件。
  2. 我们开发的中间件是构建在ASP.NET Core内置的StaticFiles中间件之上,并且在它之前运行,所有的*.md文件都被放到wwwroot文件夹下,当我们请求wwwroot下其他的静态文件的时候,StaticFiles中间件会把它们返回给浏览器,而当我们请求wwwroot下的*.md文件的时候,我们编写的中间件会读取对应的*.md文件并且把它们转换为HTML格式返回给浏览器。

文本编码检测

Nuget:Install-Package UTF.Unknown

cs 复制代码
DetectionResult result = CharsetDetector.DetectFromStream(stream);
string charset = result.Detected.EncodingName

CharsetDetector/UTF-unknown: Character set detector build in C# - .NET 5+, .NET Core 2+, .NET standard 1+ & .NET 4+https://github.com/CharsetDetector/UTF-unknownhttps://github.com/CharsetDetector/UTF-unknownhttps://github.com/CharsetDetector/UTF-unknownhttps://github.com/CharsetDetector/UTF-unknown

Markdown→HTML

Nuget:Install-Package MarkdownSharp

cs 复制代码
Markdown markdown = new Markdown();
string html = markdown.Transform(mdText);

注意

app.UseMiddleware<MarkdownMiddleware>();需在app.UseStaticFiles();之前注册,如果先注册了静态文件中间件,那么所有对静态文件的请求都会直接由静态文件中间件处理,而不会经过你的自定义中间件。

cs 复制代码
app.UseMiddleware<MarkdownMiddleware>();
//配置服务器为静态文件提供服务
app.UseStaticFiles();

实现

cs 复制代码
public class MarkdownMiddleware
{
    private readonly RequestDelegate _next;
    private readonly IWebHostEnvironment hostEnv;
    public MarkdownMiddleware(RequestDelegate next, IWebHostEnvironment hostEnv)
    {
        _next = next;
        this.hostEnv = hostEnv;
    }
    public async Task InvokeAsync(HttpContext context)
    {
        //获取请求路径
        var path = context.Request.Path.Value;
        //判断请求路径是否以.md结尾
        if (!path.EndsWith(".md", true, null))
        {
            await _next(context);
            return;
        }
        //判断请求路径是否存在
        var file = hostEnv.WebRootFileProvider.GetFileInfo(path);
        if (!file.Exists)
        {
            await _next(context);
            return;
        }
        //读取文件流
        using var stream = file.CreateReadStream();
        //UTF.Unknown检测文件编码,获取检测结果
        DetectionResult result = CharsetDetector.DetectFromStream(stream);
        string charset = result.Detected.EncodingName ?? "UTF-8";
        //流的位置重置
        stream.Position = 0;
        //读取文件内容,并指定编码
        using StreamReader reader = new StreamReader(stream, Encoding.GetEncoding(charset));
        string mdText = await reader.ReadToEndAsync();
        //将Markdown转换为HTML
        Markdown markdown = new Markdown();
        string html = markdown.Transform(mdText);
        //设置响应头
        context.Response.ContentType = "text/html;charset=UTF-8";
        await context.Response.WriteAsync(html);
    }
}
相关推荐
Ray Song18 小时前
【FastDDS】Layer DDS之Domain (01-overview)
中间件·自动驾驶·fastdds·dds层概览
Thuni_soft20 小时前
权威认证!华宇TAS应用中间件获得商用密码产品认证证书
中间件·商用密码认证
Ray Song1 天前
【FastDDS】Layer DDS之Domain ( 03-DomainParticipantListener)
中间件·自动驾驶·fastdds
ByteBlossom2 天前
SpringBoot集成Kafka实战应用
spring boot·中间件·kafka
冷冷的菜哥2 天前
ASP.NET Core上传文件到minio
后端·asp.net·上传·asp.net core·minio
驾驭人生2 天前
基本IP保护 Swagger UI 的中间件
中间件
瀚高PG实验室2 天前
金蝶中间件适配HGDB
中间件·瀚高数据库
武子康2 天前
Java-114 深入浅出 MySQL 开源分布式中间件 ShardingSphere 深度解读
java·数据库·分布式·mysql·中间件·性能优化·开源
万行2 天前
点评项目(Redis中间件)&第二部分Redis基础
java·数据库·redis·spring·中间件
ArabySide3 天前
【ASP.NET Core】双Token机制在ASP.NET Core中的实现
后端·asp.net core