📌  相关文章
📜  如何在自述文件中添加图像 (1)

📅  最后修改于: 2023-12-03 15:38:41.832000             🧑  作者: Mango

如何在自述文件中添加图像

在编写自述文件时,添加图片是非常有用的。可以通过展示作品、文档、演示、漫画等向读者展示更多信息。在 Markdown 中,通过简单的语法即可添加图片,以下是如何在自述文件中添加图像的方法:

1. 准备图片

首先,需要准备要添加的图片。图片可以是线上或线下的:

  • 在线图像:可以通过在云存储服务(如 GitHub、Dropbox、Imgur 等)中存储图像,并使用 URL 连接
  • 本地图像:可以将图像文件保存在本地目录中,并使用相对路径访问

无论使用哪种方法,确保图像路径可访问,并且您已获得有关图像使用的适当权限。

2. 添加图片

有两种方式可以在 Markdown 中添加图片:

直接在行内添加

添加图像的最简单方法是直接在行内使用感叹号和方括号。感叹号告诉 Markdown 在行内插入一个图像,方括号内包含图像的替代文本,方括号后面的圆括号则包含图像的 URL 或相对路径。例如:

![替代文本](https://github.com/yourUsername/yourRepository/raw/main/path/to/image.png)

其中,替代文本(Alternative text)是在图像无法显示时显示的文本。

使用图像参考

如果您需要在文档中多次使用相同的图像,可以使用图像参考来引用它。首先,需要在文档的另一个地方定义一个图像参考。该行使用感叹号和方括号,方括号内是对参考的简短描述,方括号后面的方括号内是一个唯一的名称,可以在文档中引用该名称。例如:

![这是一个图片](./图片.png "图片的标题")

在这里,我们给图片加上了一个标题,标题是可选的。此时,我们已经在文档中为图片添加了一个图像参考。接下来,需要在文档的其他位置使用图像参考。这时候,使用感叹号和方括号,方括号内是参考名称。例如:

![这是第二个图片][image-reference]

在文末或者其他地方,你要使用下文这样方式添加引用:

[image-reference]: ./图片.png "图片的标题"

记得若图片路径为网络路径,链接要以“HTTPS”开头以保证 Github Pages 认为是安全链接,若为以前的 “HTTP” 链接则会被拦截。

3. 附加元素

在使用感叹号、方括号和圆括号定义图像时,可以添加标题、宽度、高度和其他元素。注意,不是所有元素都适用于所有图像格式。在这里罗列几个常用选项:

  • title:指定图像的标题
  • widthheight:指定图像的宽度和高度,可以设置百分比或像素值
  • alt:指定替代文本,当图像无法加载时显示。

示例:

![替代文本](https://github.com/yourUsername/yourRepository/raw/main/path/to/image.png "图片标题" =250x250)

上述代码中的 =250x250 指定了图像的宽度和高度为 250 像素。

以上是如何在自述文件中添加图像的全部内容,我们可以选择合适自己的方法来添加图像,让文档更加丰富、生动。