关于Markdown图片无法显示的问题解决方法,Typora编写完Markdown文档后,本地图片显示正常,上载到github上或者GItee 图片无法显示的问题

本文介绍在GitHubPage或GiteePage中展示Markdown文档时,遇到的图片加载问题及解决方案。作者分享了两种方法:一是调整图片链接为完整的网络路径;二是使用HTML的img标签直接引用项目中的图片。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

如题,博主和大部分程序员一样,喜欢编写Markdown文档(下文简称MD)。

近日有一个比较懒的需求,想在手机上看MD文档,但是又不想下载app。

又想躺在床上用手机看以前写的MD文档,索性想到了Github page 和Gitee page.

于是爽快的把文档上传了。(如何在Github||Gitee上使用page功能请移步百度,该文档不详细介绍)

打开以后,发现文字显示全都正常,图片无法加载

如下图:

 

于是检查路径是否错误。

发现和根目录的图片文件夹没有问题

按照计算机的路径名应该如下

./图片文件夹/图片名.jpg

且,在本地加载没有异常,只是上传到服务器就加载异常。

MD文档的图片链接语法格式如下:

![这里填写不能显示时的图片名字](这里填写路径名)

![test](./img/test.jpg)

本地可以省略./

![test](img/test.jpg)

当然也可以使用反斜杠

![test](img\test.jpg)

也可以使用网络地址

![test](https://www.xxx.comg/img/test.jpg)

问题解决:

github和gitee不支持采用根目录的方式来链接服务器里的图片(具体以后求证)

所以,只能采用网络地址的形式来连接你GIthub Page里的项目路径名。

![test](./img/test.jpg)

转成

![test](https://用户名.github.io/项目名/raw/图片文件夹/test.jpg)

很显然,这样做很烦。而且,因为特殊的管理,直接采用/项目名/图片文件夹/图片的方式也访问不到,必须加一个raw来解决问题,就显得很繁琐

 

就有了第二种解决方式:

不采用Markdown 的图片引入语法

采用HTML的图片引入标签。(MD支持html)

<img src="图片路径"/>

这样就可以不用写一大串的网络地址了。直接访问项目的图片文件夹。

当然,你也可以用变量的方式,给网络地址存进变量,然后

 

![test](变量名/test.jpg)

 

 

 

 

 

 

 

 

 

 

 

 

### 解析 Import Error 的常见原因 当遇到 `ImportError: cannot import name 'Generic'` 错误时,通常意味着尝试从模块中导入的对象不存在或无法访问。此问题可能由多种因素引起: - 版本不兼容:不同库之间的版本冲突可能导致此类错误。 - 安装缺失:目标库未正确安装或路径配置有误。 - 导入语句不当:可能存在循环依赖或其他语法层面的问题。 ### 针对 Generic 类型的具体解决方案 对于特定于 `Generic` 的情况,考虑到 Python 中 `Generic` 是 typing 模块的一部分,在处理该类别的 ImportError 时可采取如下措施[^1]: #### 方法一:确认typing模块可用性 确保环境中已安装标准库中的 typing 模块,并且其版本支持所使用的特性。可以通过以下命令验证: ```bash python -c "from typing import Generic; print(Generic)" ``` 如果上述命令执行失败,则可能是由于 Python 或者相关扩展包的版本过低造成的。此时应考虑升级至更高版本的解释器以及对应的开发工具链。 #### 方法二:调整导入方式 有时直接通过顶层命名空间来获取所需组件会更稳定可靠。修改代码以采用这种做法可能会解决问题: ```python from collections.abc import Iterable # 如果是迭代器相关接口 from typing import TypeVar, Protocol # 对于协议和泛型定义 T = TypeVar('T') class MyContainer(Protocol[T]): ... ``` 注意这里并没有显式提到 `Generic` ,而是利用了更为基础的数据结构抽象基类或是其他替代方案实现相同功能[^2]。 #### 方法三:排查环境变量设置 检查系统的 PYTHONPATH 和虚拟环境配置是否正常工作。任何异常都可能导致某些第三方软件包找不到必要的资源文件而引发类似的错误提示。建议清理并重建项目专属的工作区以便排除干扰项的影响。 #### 示例修正后的代码片段 假设原始代码试图这样引入 `Generic` : ```python from some_module import Generic # 可能导致 ImportError ``` 改为遵循官方文档推荐的方式后变为: ```python from typing import Generic # 正确的做法 ```
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值