是否可以将屏幕快照放置在GitHub存储库中的README文件中？语法是什么？

如果您使用Markdown（README.md）：

如果您的存储库中有图片，则可以使用相对URL：

![Alt text](/relative/path/to/img.jpg?raw=true "Optional Title")

如果您需要嵌入在其他位置托管的图像，则可以使用完整的URL

![Alt text](http://full/path/to/img.jpg "Optional title")

GitHub建议您在参数中使用相对链接，?raw=true以确保正确的分叉存储库点。

该raw=true参数存在以确保您链接到的图像将按原样呈现。这意味着将仅链接图像，而不链接该文件的整个GitHub接口。有关更多详细信息，请参见此评论。

查看示例：https : //raw.github.com/altercation/solarized/master/README.md

如果您使用SVG，则还需要将sanitize属性设置true为?raw=true&sanitize=true。（感谢@EliSherer）

另外，有关README文件中相对链接的文档：https : //help.github.com/articles/relative-links-in-readmes

当然，降价文档：http：//daringfireball.net/projects/markdown/syntax

此外，如果您创建一个新分支screenshots来存储图像，则可以避免将它们放入master工作树中

然后，您可以使用以下方法嵌入它们：

![Alt text](/../<branch name>/path/to/image.png?raw=true "Optional Title")

即使已经有一个可接受的答案，我还是想添加另一种在GitHub上将图像上传到自述文件的方法。

• 您需要在回购中创建问题
• 将您的图片拖放到评论区域
• 生成图像的链接后，将其插入到您的自述文件中

您可以在此处找到更多详细信息

我发现回购中映像的路径不足，我必须链接到raw.github.com子域上的映像。

网址格式 https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH}

降价示例 ![Settings Window](https://raw.github.com/ryanmaxwell/iArrived/master/Screenshots/Settings.png)

1. 将您的图片上传到postimage.org
2. 获取github Markdown网址
3. 插入您的自述文件

下面的一行应该是您想要的

如果您的文件在存储库中

![ScreenShot](https://raw.github.com/{username}/{repository}/{branch}/{path})

如果您的文件在其他外部网址中

![ScreenShot](https://{url})

用于显示图像的markdown语法确实是：

![image](https://{url})

但：如何提供url？

• 您可能不想用截图来使您的仓库杂乱无章，它们与代码无关
• 您可能不想处理使图像在Web上可用的麻烦...（将其上传到服务器...）。

所以...您可以使用这个很棒的技巧使github托管您的图像文件。TDLR：

1. 在您的仓库的问题清单上创建问题
2. 拖放此问题的屏幕截图
3. 复制github刚刚为您显示的markdown代码以显示图像
4. 将其粘贴到您的自述文件（或任何您想要的地方）上

http://solutionoptimist.com/2013/12/28/awesome-github-tricks/

比添加URL简单得多。只需将图像上传到同一存储库即可，例如：

![Screenshot](screenshot.png)

将此添加到自述文件

<div align="center">
    <img src="/screenshots/screen1.jpg" width="400px"</img> 
</div>

降价： ![Screenshot](http://url/to/img.png)

• 创建有关添加图像的问题
• 通过拖放或文件选择器添加图像

• 然后复制图像源

• 现在添加![Screenshot](http://url/to/img.png)到您的README.md文件

做完了！

或者，您可以使用某些图像托管站点，例如，imgur并获取其URL并将其添加到README.md文件中，也可以使用一些静态文件托管。

样本问题

方法1->降价方式

![Alt Text](https://raw.github.com/{USERNAME}/{REPOSITORY}/{BRANCH}/{PATH})

方法2-> HTML方式

<img src="https://link(format same as above)" width="100" height="100"/>

要么

<img src="https://link" style=" width:100px ; height:100px " />

注意 ->如果您不想样式化图像，即调整大小，请删除样式部分

首先，在本地存储库的根目录中创建一个目录（文件夹），其中将包含screenshots要添加的目录。我们称这个目录的名称screenshots。将要添加的图像（JPEG，PNG，GIF等）放入此目录。

Android Studio工作区屏幕截图

其次，您需要在自述文件中添加每个图像的链接。因此，如果我的图片名为，1_ArtistsActivity.png并且2_AlbumsActivity.png在我的屏幕快照目录中，我将添加其链接，如下所示：

 <img src="screenshots/1_ArtistsActivity.png" height="400" alt="Screenshot"/> <img src=“screenshots/2_AlbumsActivity.png" height="400" alt="Screenshot"/>

如果要将每个屏幕截图放在单独的行中，请在单独的行中编写它们的链接。但是，最好将所有链接写在一行中，并仅用空格分隔。它实际上看起来可能不太好，但是通过这样做，GitHub会自动为您安排它们。

最后，提交您的更改并推动它！

我在Google上搜索了一些类似的问题，但没有看到关于我的问题及其相当简单/容易解决方案的任何答案。

Google云端存储-自述文件中的图像略有不同的方法

就像OP一样，我想在我的Github README中添加一个图像，然后知道Markdown语法，将其输入：

![My Image](https://storage.cloud.google.com/${MY_BUCKET}/${MY_IMAGE}

您需要完成上面的实际替换（例如MY_IMAGE = image.jpg），此功能才能起作用。

但是，等等...失败-没有实际的渲染照片！链接与Google Storage给出的完全一样！

Github- camo匿名图片

Github匿名托管您的图片，是的！但是，这为Google存储资产带来了问题。您需要从Google Cloud Console获取生成的网址。

我敢肯定有一种更平滑的方法，但是，只需访问您给定的URL端点并复制长URL。细节：

使用说明

1. 访问您的存储控制台： https //console.cloud.google.com/storage/browser/ //console.cloud.google.com/storage/browser/ $ {MY_BUCKET}？project = $ {MY_PROJECT}
2. 单击您要在Github中显示的图像（这将显示“对象详细信息”页面）
3. 复制该网址的意大利面（以“ httpsnot” 开头的gs到新的浏览器标签/窗口中
4. 将面食从新的浏览器标签/窗口复制到新生成的URL（应该更长）中，并将其复制到Github自述文件中

希望这有助于加快速度，并为其他人澄清这个问题。

对我来说最好的方法是-

1. 在github上使用该存储库创建一个新问题，然后以gif格式上传文件。要将视频文件转换为gif格式，您可以使用此网站 http://www.online-convert.com/
2. 提交新创建的问题。
3. 复制上传文件的地址
4. 最后，在您的自述文件中加入！[demo]（COPIED ADDRESS）

希望这会有所帮助。

从上传文件选项在存储库中添加图像，然后在自述文件中添加图像

![Alt text]("enter image url of repositoryhere") 

图像位于/screen-shots目录中。外部<div>允许放置图像。使用可以实现填充<img width="desired-padding" height="0">。

<div align="center">
        <img width="45%" src="screen-shots/about.PNG" alt="About screen" title="About screen"</img>
        <img height="0" width="8px">
        <img width="45%" src="screen-shots/list.PNG" alt="List screen" title="List screen"></img>
</div>