【优快云博客与Markdown】工具 dotnet-cnblog：解决markdown上传csdn无法显示本地图片的问题

1、无法显示图片的问题

现象展示

我们在 优快云 上写文章，将自己本地的Markdown文档笔记上传到优快云，可能会出现如下图片加载失败的情况：

原因解释

这是因为图片在我们系统本地，csdn无法从我们的本地识别图片，如下图

![外链图片转存失败，源站可能有防盗链机制，建议将图片保存下来直接上传](https://img-
home.csdnimg.cn/images/20230724024159.png?.....

因为markdown文档加载和显示图片靠的是链接，而非将图片本地直接保存到一个 markdown 文件中，当你打开并阅读 .md 文件时，该文件会通过图片链接路径来找到并加载该图片，因此，直接将我们的 本地markdown笔记导入或复制到优快云上，上传的不是图片，而是图片的链接，该链接是一个本地链接，不能在优快云网页上链接到我们本地的电脑系统。

解决办法

想办法将我们图片上传至网络端，使得优快云上图片能够根据一个网络地址，在网络中链接找到图片

那我们也可以直接把图片变成url（URL 是一种地址，用于告诉浏览器或应用程序如何找到某个特定的网页、文件或其他资源），这样我们写优快云或其他网络博客就不用傻乎乎的一张一张的上传了（费时费力）。

下面我们推荐通过一个工具将图片的本地链接直接变成 URL： dotnet-cnblog

2、工具 dotnet-cnblog

2.1 原理解析

该工具的原理是识别 markdown 文件里所有的图片，然后转换本地图片为URL

他会将处理好的文档复制一份副本，放到被处理文档的同级目录下

2.2 注意事项

该工具只能识别下面这种格式的图片：这是 Markdown 格式

![image-20250305103914773](C:\Users\Typora\typora-user-images\image-20250305103914773.png)

不能识别这种：这种是 HTML 格式图片

<img src="C:\Users\Typora\typora-user-images\image-20250305103914773.png" alt="image-20250305103914773" />

解决办法：

右键点击 markdown文件中的 HTML格式图片，按照图片展示那样，将图片的语法转换为 Markdown 格式：

2.3 准备工作

（1）下载程序

• 下载一个 .NET SDK ：下载 .NET(Linux、macOS 和 Windows) (microsoft.com)

  下载之后运行exe安装程序就行，不用指定路径，默认c盘

• 确保安装完成：安装完成直接打开cmd窗口，运行 dotnet --info 确认安装完成

（2）博客园

• 注册博客园账号
  这个正常注册即可
• 注册一个博客网址
  点击博客园头像，找到 “账号设置”，找到 “博客设置”（如下图），然后他就会指引你注册一个博客网址（如 https://www.cnblogs.com/某某某 的博客网址）

【 404 Not Found 报错】千万注意，注册账号和注册网址不是同一个东西，如果你仅仅是注册账号而没有注册网址，在使用我们这个工具时，就会出现 404 Not Found 报错！

上传失败，正在重试 1，异常：The remote server returned an error: (404) Not Found.
上传失败，正在重试 2，异常：The remote server returned an error: (404) Not Found.
上传失败，正在重试 3，异常：The remote server returned an error: (404) Not Found.
上传失败,异常：The remote server returned an error: (404) Not Found.
The remote server returned an error: (404) Not Found.

2.4 安装工具 dotnet-cnblog

在 cmd 命令行窗口上，输入 dotnet tool install -g dotnet-cnblog 进行安装。

安装好之后直接输入 dotnet-cnblog 打开程序，就能运行了，如下图

2.5 配置 dotnet-cnblog

（1）配置过程

输入 dotnet-cnblog proc -f 使用该工具，使用之前，若你没有配置过，他就会提示你进行配置：配置前先看我们下面的注意事项

输入 dotnet-cnblog reset ：可以对 dotnet-cnblog 重新配置（如果你配置写错了）

（2）注意事项

配置过程中必须注意这几点：

• 提示输入博客ID：
  • 意思是让你输入你博客网址的ID，不是将整个网址放上去！！！
  • 如：https://www.cnblogs.com/stulzq 的博客id为 stulzq，然后将博客ID stulzq 输入即可！
  • 如果你将网址输入上去，则无法正确配置，该工具将你图片上传到网络时就会错误识别你的 博客ID 导致找不到你的博客地址，最终导致上传失败，还会产生如下报错：

上传失败，正在重试 1，异常：The remote server returned an error: (404) Not Found.
上传失败，正在重试 2，异常：The remote server returned an error: (404) Not Found.
上传失败，正在重试 3，异常：The remote server returned an error: (404) Not Found.
上传失败,异常：The remote server returned an error: (404) Not Found.
The remote server returned an error: (404) Not Found.

• 提示输入用户名

  • 这个用户名是输入你博客园账号的名字，不是上面的博客ID（如果两者相同当我没说）
    
    

• 提示输入密码

  • 千万注意，这个秘密不是你博客园的登录密码，而是博客密钥

  • 创建密钥：点击博客园头像，找到 “账号设置”，点击下图所示的 Access Tokens ，创建一个令牌，然后将令牌（一串字符串）复制到 cmd 中（它要求你输入的密码中）
    

  • 如果你输入的密码，不是令牌，则在使用工具时可能会导致 【401报错】
    
    
    

2.6 使用 dotnet - cnblog

配置之后就可以开始 转换 图片为url了

cmd中 输入

dotnet-cnblog proc -f <markdown文件路径>

注意：该文件路径中最好不要有空格，否则可能导致它找不到你的文件，最终导致 上传失败

下面就是上传成功了：必须要提取成功以及上传成功

2.7 效果展示

他会在被处理文件所在路径下生成一个拷贝件，后面加上 -cnblog 的字样

下图展示了处理效果，上面是处理前的本地链接，下面是处理后 的

至此，我们的工具的使用教程介绍完成，之后我们写优快云博客，直接将处理后的文件复制到优快云的编辑器上即可！

注：借鉴于该博客，主要优化一些逻辑表述与添加一些可能会到的报错及其解决办法 （https://blog.youkuaiyun.com/m0_73689941/article/details/133953953）