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);
    }
}
相关推荐
用户768553412553811 小时前
文档站的截图和示例工程都塞进 Git 仓库后,我把素材托管重新理了一遍
markdown
飞奔的瓜牛2 天前
Kafka 生产实践指南:使用要点、性能优化与运维维护
中间件·性能优化·kafka
木头左2 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
九英里路3 天前
protobuf快速上手
网络·c++·中间件·json·谷歌·序列化·protobuf
FungLeo5 天前
成为全栈·Vue 管理后台篇·编辑器图片上传:从文件选择到文章附件关联
前端·vue.js·编辑器·markdown·文件上传·formdata·附件管理
lsc_blog5 天前
听到优化风声,先准备能由自己掌控的事
数据库·分布式·中间件·职场和发展·重构
king王一帅8 天前
当 DSH 适配了 Quirekit md-editor: 你的笔记软件为何不能是 DSH(MIT开源)
agent·markdown·deepseek
大草原的小灰灰10 天前
LLM应用的标准开发框架LangChain(八)- 中间件
python·中间件·langchain
用户2986985301410 天前
Python 实战:将 HTML 批量转换为 Markdown
python·html·markdown
喵喵匠11 天前
一份 Markdown 发十个平台:cspub 一稿多投
自动化·markdown·效率工具·仓颉·cli工具