博客园 Markdown 图片上传踩坑与解决方案

1、在某次写博客的时候发现本地的md文档复制到博客园图片无法正常显示

这是因为Image的地址不规范导致，我之前的操作一直是复制，保存，删除，这次由于使用了snipaste截图。结合Typora看能不能有一劳永逸的办法

在Typora中看到的图片，使用的是本地绝对路径，比如：C:\Users\xxx\Roaming\Typora\typora-user-images\image-20260608144159953.png。

这个路径指向的是您自己电脑硬盘上的文件。当您把MD文档传到博客园后，博客园的服务器不可能访问到您电脑的硬盘，所以图片自然就无法加载了

方案名称	核心原理	优点	缺点/注意
方案一：使用 dotnet-cnblog 工具	一个命令行工具，会扫描您的整个MD文件，将所有本地图片一键上传到博客园，并生成一个-cnblog.md的新文件，直接复制这个新文件的内容发布即可。	简单粗暴，一步到位，无需复杂配置，适合整篇文章完成后一次性处理。	需要安装.NET环境，是命令行操作，会生成新文件。
方案二：使用Typora的“自定义命令”上传	在Typora的图片插入设置里，配置一个上传服务。之后您在Typora里粘贴或拖入图片时，软件就自动将其上传到图床，并替换链接。	体验极佳，无缝集成，写文档时就自动完成了上传，最接近Word的体验。	初次配置相对复杂一些，需要找一个合适的“上传服务”（可以是下面的EasyBlogImageForTypora，或者是用Python脚本）。

我们这次先使用方案1

实战：使用 dotnet-cnblog 一键处理现有文档

这是目前博客园社区里最流行的解决方案之一，操作并不复杂

1. 准备工作（仅需一次）：

   • 在博客园后台【设置】->【博客设置】->【允许MetaWeblog博客客户端访问】，勾选并保存，然后点击“查看MetaWeblog访问令牌”，创建一个令牌并记下这个令牌（相当于密码）。

2. 安装工具：

   • 在电脑上搜索并安装.NET SDK 5.0，因为该工具依赖此环境。

   • 安装完成后，打开命令提示符（cmd），输入以下命令安装工具：

     bash

     dotnet tool install -g --version 1.4.0 dotnet-cnblog
     

     注意：建议指定1.4.0版本，它比较稳定。

3. 配置与登录：

   • 在cmd中输入dotnet-cnblog reset，程序会引导您输入博客的相关信息（博客地址、用户名、刚刚记下的令牌）。

     如果看到

     

     证明成功了！

4. 处理您的MD文件：

   • 在cmd中，导航到您存放MD文件的目录。

   • 输入以下命令并回车：

     bash

     dotnet-cnblog proc -f 您的博客文件名.md
     

   • 工具会飞快运行，将所有本地图片上传到博客园，并将MD文件中的图片链接替换为网络链接。

5. 发布博客：

   • 运行结束后，您会在同一目录下看到一个名为您的博客文件名-cnblog.md的新文件。
   • 用Typora打开这个新文件，检查一下图片是否都能正常显示了。
   • 最后，把这个-cnblog.md文件里的全部内容，复制粘贴到博客园的文章编辑器中（确保编辑器处于Markdown模式），发布即可！