C#解析Markdown文档，实现替换图片链接操作
前言
又是好久没写博客了
其实也不是没写，是最近在「做一个博客」，从2月21日开始，大概一个多星期的时间，疯狂刷进度，边写代码边写了一整系列的博客开发笔记，目前为止已经写了16篇了，然后上3月之后工作有点忙加上有点沉迷原神，然后进度就暂时慢下来了
事实证明做什么事情一旦停下来就会产生惰性，于是停了这么久，我终于下定决心继续更新！
这次开发的博客用的是C#语言，搭配.netcore技术栈；前端继续用我比较熟悉的Bootstrap做布局，然后稍微折腾一下；管理端用的是Vue…… 过程中总能遇到一些技术问题，除了在博客开发笔记系列里记录，还是把一些普适性的解决方案单独拿出来。
我的博客采用程序员最爱的Markdown语法书写，而众所周知markdown有一个缺点就是关联图片资源麻烦
因为我的博客需要实现本地用Typora写的Markdown文档导入，所以解析markdown文档并处理导入图片资源是一个绕不过的坎。
如题，本文介绍的是C#解析Markdown文档。
Markdig库
之前我用Python实现过解析Markdown文档，Python生态里相关的库太多了，有很多很好的选择，之前我写的用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);
这个文档的部分内容如下：
## 前言
前段时间无聊回坑玩《开罗拉面店》，这是一款模拟经营类的小游戏，不管是画风还是游戏性都很对我胃口。
里面有一个玩法是拉面店布局，就给你一块地，还有几家店铺，你可以随便铺随便摆，当然肯定是摆的越多家店铺越好。
我一开始玩的时候也没想那么多，随便摆了摆就完事了，但玩到后期人气上不去，我就突发奇想，能不能把所有店铺摆进去？或者能不能尽可能多地去铺满这块地？
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());
}
最终实现的效果就是这样
## 前言
前段时间无聊回坑玩《开罗拉面店》，这是一款模拟经营类的小游戏，不管是画风还是游戏性都很对我胃口。
里面有一个玩法是拉面店布局，就给你一块地，还有几家店铺，你可以随便铺随便摆，当然肯定是摆的越多家店铺越好。
后续
能实现把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