前言
又是好久没写博客了
其实也不是没写,是最近在「做一个博客」,从2月21日开始,大概一个多星期的时间,疯狂刷进度,边写代码边写了一整系列的博客开发笔记,目前为止已经写了16篇了,然后上3月之后工作有点忙加上有点沉迷原神,然后进度就暂时慢下来了
事实证明做什么事情一旦停下来就会产生惰性,于是停了这么久,我终于下定决心继续更新!
这次开发的博客用的是C#语言,搭配.netcore技术栈;前端继续用我比较熟悉的Bootstrap做布局,然后稍微折腾一下;管理端用的是Vue…… 过程中总能遇到一些技术问题,除了在博客开发笔记系列里记录,还是把一些普适性的解决方案单独拿出来。
我的博客采用程序员最爱的Markdown语法书写,而众所周知markdown有一个缺点就是关联图片资源麻烦
因为我的博客需要实现本地用Typora写的Markdown文档导入,所以解析markdown文档并处理导入图片资源是一个绕不过的坎。
如题,本文介绍的是C#解析Markdown文档。
Markdig库
之前我用Python实现过解析Markdown文档,Python生态里相关的库太多了,有很多很好的选择,之前我写的用Python实现解析Markdown的文章:python实现解析markdown文档中的图片,并且保存到本地~
然而C#这边基本没啥可选的,官方的Markdown库也标记为弃用状态,推荐迁移到Markdig
这个库……
所以就没得选了,只能用这个Markdig。
官方介绍:
Markdig is a fast, powerful, CommonMark compliant, extensible Markdown processor for .NET.
其实这个库也不难用,但注意官方介绍里有这么一句话:
NOTE: The repository is under construction. There will be a dedicated website and proper documentation at some point!
喵的!就是完全没文档,用法基本靠猜和啃源码 ヽ(ー_ー)ノ
为了实现这个markdown图片导入,我只能硬着头皮搞起来
实现思路
Markdig有一个管道机制
举个例子的伪代码如下:
var pipeline = new MarkdownPipelineBuilder().UseExt1().UseExt2().UseExt3().Build();
var result = Markdown.ToHtml("This is a text with some *emphasis*", pipeline);
可以在解析Markdown过程中对Markdown文档做一些修饰处理
一开始我想到自己写一个管道来实现将Markdown里的图片链接做替换处理
然而(可能因为太菜)看了好几个官方的管道代码,也没琢磨出怎么实现我要的效果
直到我回想起官方介绍里的一个关键词:CommonMark compliant
,就是说这玩意是兼容CommonMark
的
灵光一闪,Markdig因为是新项目还没文档,那作为老项目的CommonMark
总有文档吧,于是我去找到了CommonMark.NET
项目,一看果然有文档,虽然两者的API并不完全一致,但经过我的半蒙半猜的探索,终于是把要的功能搞定了~ ( ̄▽ ̄)~*
实现代码
终于上代码啦~
首先读取一个Markdown文档,得到MarkdownDocument
对象
// 引入需要用到的命名空间
using Markdig;
using Markdig.Renderers.Normalize;
using Markdig.Syntax;
using Markdig.Syntax.Inlines;var filepath = "temp/blog/机器学习/多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.md";
var md = File.ReadAllText(filepath);
var document = Markdown.Parse(md);
这个文档的部分内容如下:
## 前言
前段时间无聊回坑玩《开罗拉面店》,这是一款模拟经营类的小游戏,不管是画风还是游戏性都很对我胃口。![](多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-ea70bbc1e5c28b62.png)![](多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-3dd13511e9063800.png)![](多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-8fcc0475f92cfc84.png)里面有一个玩法是拉面店布局,就给你一块地,还有几家店铺,你可以随便铺随便摆,当然肯定是摆的越多家店铺越好。![](多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-f2c6578cb8f77c31.png)我一开始玩的时候也没想那么多,随便摆了摆就完事了,但玩到后期人气上不去,我就突发奇想,能不能把所有店铺摆进去?或者能不能尽可能多地去铺满这块地?
Markdig会把Markdown文档解析成一个文档树,接下来可以像DOM操作那样遍历文档节点了~
下面的代码是找出Markdown中的图片链接节点,并给图片链接加上前缀
foreach (var node in document.AsEnumerable()) {if (node is ParagraphBlock { Inline: { } } paragraphBlock) {foreach (var inline in paragraphBlock.Inline) {if (inline is LinkInline {IsImage: true} linkInline) {// 这里就是图片链接了// 实现给图片链接加上前缀linkInline.Url = $"http://127.0.0.1:5038/assets/blog/{linkInline.Url}";Console.WriteLine(linkInline.Url);}}}
}
然后把修改完的Markdown文档重新输出:
using (var writer = new StringWriter()) {var render = new NormalizeRenderer(writer);render.Render(document);Console.WriteLine(writer.ToString());
}
最终实现的效果就是这样
## 前言前段时间无聊回坑玩《开罗拉面店》,这是一款模拟经营类的小游戏,不管是画风还是游戏性都很对我胃口。![](http://127.0.0.1:5038/assets/blog/多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-ea70bbc1e5c28b62.png)![](http://127.0.0.1:5038/assets/blog/多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-3dd13511e9063800.png)![](http://127.0.0.1:5038/assets/blog/多个约束条件下的二维装箱问题——寻找《开罗拉面店》最优布局.assets/8869373-8fcc0475f92cfc84.png)里面有一个玩法是拉面店布局,就给你一块地,还有几家店铺,你可以随便铺随便摆,当然肯定是摆的越多家店铺越好。
后续
能实现把markdown文档里的图片链接拿出来,那后续的图片导入、链接替换就好办了,当然这是博客开发笔记里的内容,本文就不写了。
C#语言很不错,可惜第三方库的生态还是差了点,这个问题如果我用Python的话早就解决了,但C#的话就只能折腾,我甚至一度想要自己造个轮子来解析了……
其实应该不难,我想到的办法就是每一行遍历文档,然后用正则表达式把图片链接匹配出来,后续处理完成再用正则做替换,不过不太优雅就是了,在这个写代码靠copy的时代还是要有点追求,不然跟咸鱼有什么区别呢……
然后再唠一下最近在搞的好玩的东西:
受俄乌战争警醒的「去Windows化」
寻找国内的微信替代品「去腾讯化」
OK,接下来应该会开始更新博客开发笔记系列文章~(*^▽^*)
参考资料
CommonMark.NET Wiki:https://github.com/Knagis/CommonMark.NET/wiki
Markdig项目主页:https://github.com/xoofx/markdig
相关issues:https://github.com/xoofx/markdig/issues/599
相关源码:https://github.com/xoofx/markdig/blob/master/src/Markdig/Renderers/Normalize/NormalizeRenderer.cs
微软文档:https://docs.microsoft.com/en-us/windows/communitytoolkit/parsers/markdownparser
https://www.songshizhao.com/blog/blogPage/1044.html