📅  最后修改于: 2023-12-03 15:38:41.832000             🧑  作者: Mango
在编写自述文件时,添加图片是非常有用的。可以通过展示作品、文档、演示、漫画等向读者展示更多信息。在 Markdown 中,通过简单的语法即可添加图片,以下是如何在自述文件中添加图像的方法:
首先,需要准备要添加的图片。图片可以是线上或线下的:
无论使用哪种方法,确保图像路径可访问,并且您已获得有关图像使用的适当权限。
有两种方式可以在 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” 链接则会被拦截。
在使用感叹号、方括号和圆括号定义图像时,可以添加标题、宽度、高度和其他元素。注意,不是所有元素都适用于所有图像格式。在这里罗列几个常用选项:
title
:指定图像的标题width
和 height
:指定图像的宽度和高度,可以设置百分比或像素值alt
:指定替代文本,当图像无法加载时显示。示例:
![替代文本](https://github.com/yourUsername/yourRepository/raw/main/path/to/image.png "图片标题" =250x250)
上述代码中的 =250x250
指定了图像的宽度和高度为 250 像素。
以上是如何在自述文件中添加图像的全部内容,我们可以选择合适自己的方法来添加图像,让文档更加丰富、生动。