Gitee上传Markdown文档后图片无法读取问题解决

目录

正文

问题原因

一、绝对路径方式(繁琐 不推荐)

1  上传你的 Markdown 文本以及相关的图片资源文件

2  打开 .md 文件进行编辑

3  浏览器新建窗口进入 Gitee 打开图片文件点击原始数据按钮

4  复制对应的 URL 到要显示 md 文档的图片显示地址区域

 5  修改完毕后提交修改

 6  显示成功

二、相对路径方式(推荐)

1 创建一个新的 markdown 文档并添加img文件夹

2 复制图片到 img 文件夹, 修改 markdown 文本图片路径

3 上传笔记文档(包括 img 文件夹和 md 笔记)

步骤

完结撒花~~~

---

正文

问题原因

---

由于 Markdown 文档在书写时,是通过图片的绝对路径来进行显示的,或者说通过网页的 URL 进行显示。那么你在上传到 Gitee 之后,图片的路径发生了变化,此时你就需要修改 Markdown 文档的图片路径才可以完成显示(如果你采用的绝对路径方式导入图片资源的话)。

下来我们介绍一种比较简单的方式:

一、绝对路径方式(繁琐 不推荐)

---

1  上传你的 Markdown 文本以及相关的图片资源文件

 下图中 GIt学习笔记.asserts 是我的图片资源文件夹

2  打开 .md 文件进行编辑

3  浏览器新建窗口进入 Gitee 打开图片文件点击原始数据按钮

如下点击原始数据按钮之后会全屏展示图片,此时浏览器地址栏就出现了我们要填入的 URL

 URL如红线所示

4  复制对应的 URL 到要显示 md 文档的图片显示地址区域

这里     是 Markdown 的语法,括号内是图片位置

 5  修改完毕后提交修改

 6  显示成功

---

对于修改 Markdown 文档的方式,我们还可以直接在本地进行修改,然后 push 到 Gitee 库中同样也可以得到相同的效果。

在查阅资料的过程中, 了解到还可以使用 Typora+Picgo+Gitee 的方式完成图片路径的自动修改,也即我们可以省去修改 Markdown 文档的麻烦。对此,由于教程比较繁琐,并且对于库的开放权限有效求,我们就不再尝试使用该方法。

有需要的小伙伴可以自行尝试~

---

二、相对路径方式(推荐)

除了上述说的绝对路径的方式,我们可以使用相对路径的方式,也即使用如下的 Markdown 语法。

![image-20210924181321130](img/image-20210924181321130.png)

1 创建一个新的 markdown 文档并添加img文件夹

---

 如果有使用 Typora 的小伙伴, 还可以在里面设置如下属性, 这样剪切来的图就会直接在笔记同目录下生成 img 文件夹并且存放了, 一劳永逸简直美滋滋!!!

也就是设置了这里之后, 在你使用 Typora 编辑文档时粘贴图片就不在需要你去操作了, 软件会自动为你新建 img 文件并将图片存储在 img 文件夹内, 并且你的图片访问路径也会以相对路径的方式进行保存。(上传 gitee 的时候记得将 文档和图片一起上传哦~)

2 复制图片到 img 文件夹, 修改 markdown 文本图片路径

图片需要保存到刚才创建的 img 文件夹下, 然后贴上相对路径

比如保存到 img 文件夹下的图片名为  1.jpg。 那么你修改 marddown 文档内链接方式如下图即可(相对路径)。

![image-20210924181321130](img/1.jpg)

3 上传笔记文档(包括 img 文件夹和 md 笔记)

 如下图所示, 把演示文档这个文件夹进行上传即可。

总结来说就是采用相对路径的方式标记图片位置在 markdown 文档中显示。

步骤

• 创建  markdown  文档  1.md  并且在同路径下创建  img  文件夹存放资源图片
• 在  markdown  文档中通过相对路径方式引用图片
• 上传文档 和  img  文件夹到  gitee  (建议再创建一个新文件夹)

 这样你就可以直接上传所有资源文件(包括图片文件哦) Gitee 并且在网页上看到笔记的图片了。

完结撒花~~~