最近我加入了GitHub。我在那里主持了一些项目。

我需要在README文件中包含一些图像。我不知道该怎么做。

我搜索了一下,但得到的只是一些链接,告诉我“在web上托管图像并在README.md文件中指定图像路径”。

是否有任何方法可以在不在任何第三方网络托管服务上托管图像的情况下做到这一点?


当前回答

在新的Github UI中,这对我有用-

示例-在文件夹(myFolder)中提交image.png,并在README.md中添加以下行:

![Optional Text](../main/myFolder/image.png)

其他回答

你可以这样做:

git checkout --orphan assets
cp /where/image/currently/located/on/machine/diagram.png .
git add .
git commit -m 'Added diagram'
git push -u origin assets

然后,您可以在README文件中引用它,如下所示:

![diagram](diagram.png)

我只是在已经接受的答案上延伸或添加一个例子。

一旦您将图像放到Github存储库中。

然后:

在浏览器上打开相应的Github repo。导航到目标图像文件,然后在新选项卡中打开图像。复制url最后将url插入到以下模式![替换文本](https://raw.githubusercontent.com/username/projectname/branch/path/to/img.png)

就我的情况而言

![在一张图片中](https://raw.githubusercontent.com/shadmazumder/Xcode/master/InOnePicture.png)

哪里

shadmazumder是我的用户名Xcode是项目名称master是分支InOnePicture.png是图像,在我的情况下,InOnePicture.php位于根目录中。

尝试此标记:

![alt text](http://url/to/img.png)

我认为,如果图像存储在存储库中,您可以直接链接到原始版本的图像。即

![alt text](https://github.com/[username]/[reponame]/blob/[branch]/image.jpg?raw=true)

还有一个选项我还没有看到。您可以简单地在用户或组织下创建另一个名为“资产”的存储库。将您的图像推送到此回购,并从其他回购中引用它们:

![alt text](https://raw.githubusercontent.com/my-org/assets/master/folder/logo.png)

我在我的一次回购中做了这件事,它很适合我。我可以独立于我的代码为我的所有项目版本我的README图像,但仍然将它们保存在一个地方。不需要问题、分支或其他容易错位的工件。

您还可以像任何其他格式一样在markdown文件中插入动画SVG图像。它可以很好地替代GIF图像。

![image description](relative/path/in/repository/to/image.svg)
OR
<img src="relative/path/in/repository/to/image.svg" width="128"/>

示例(假设图像位于存储库中的assets目录中):

![My animated logo](assets/my-logo.svg)

结果:


要使用基于GitHub深色/浅色主题的不同图像,请参阅本文。