最近我加入了 GitHub。我在那里主持了一些项目。
我需要在我的 README 文件中包含一些图像。我不知道该怎么做。
我对此进行了搜索，但我得到的只是一些链接，这些链接告诉我“在网络上托管图像并在 README.md 文件中指定图像路径”。
有没有办法在不将图像托管在任何第三方网络托管服务上的情况下做到这一点？
【问题讨论】：
标签： github markdown github-flavored-markdown readme
试试这个降价：
如果图像存储在您的存储库中，我认为您可以直接链接到图像的原始版本。即
【讨论】：
https://github.com/[username]/[reponame]/blob/[branch]/image.jpg?raw=true
你也可以使用相对路径
还可以使用所需的.fileExtention 尝试以下操作：
【讨论】：
这是一个详细的 YouTube 视频，详细解释了这一点：
【讨论】：
只需将您的图像上传到存储库根目录，并链接到不带任何路径的文件名，如下所示：
【讨论】：
docs/images 或其他任何情况，恕我直言，小 png 屏幕截图还可以
logo.png 图片为回购设置头像。我想将这张图片包含在 README.md 中。
你也可以用简单的HTML标签添加图片：
<p align="center">
<img src="your_relative_path_here" width="350" title="hover text">
<img src="your_relative_path_here_number_2_large_name" width="350" alt="accessibility text">
</p>
【讨论】：
许多已发布的解决方案不完整或不合我的口味。
受this gist 启发，我首选的解决方案是使用assets 分支，并带有特定修订的永久链接。
git checkout --orphan assets
git reset --hard
cp /path/to/cat.png .
git add .
git commit -m 'Added cat picture'
git push -u origin assets
git rev-parse HEAD # Print the SHA, which is optional, you'll see below.
为这个版本的图像构建一个“永久链接”，并将其包装在 Markdown 中。
但是，手动查找提交 SHA 很不方便，因此作为快捷方式按 Y 可以永久链接到特定提交中的文件as this help.github page says.
要始终在资产分支上显示最新图像，请使用 blob URL：
https://github.com/github/{repository}/blob/assets/cat.png
（来自同一 GitHub 帮助页面 File views show the latest version on a branch）
【讨论】：
git reset --hard；确保更改已提交。
~/Downloads、/tmp 等）。
提交您的图像 (image.png) 并在您的 README 中添加以下行。 md：
【讨论】：
我需要在我的 README 文件中包含一些图片。我不知道怎么做 这样做。
我创建了一个小向导，允许您为 GitHub 存储库的自述文件创建和自定义简单的图片库：请参阅 ReadmeGalleryCreatorForGitHub。
该向导利用了 GitHub 允许 img 标签出现在 README.md 中这一事实。此外，该向导还利用了流行的技巧，即通过将图像拖放到问题区域中来将图像上传到 GitHub（如本主题的一个答案中所述）。
【讨论】：
您也可以像任何其他格式一样在降价文件中插入animated SVG images。
它可以很好地替代 GIF 图片。
OR
<img src="relative/path/in/repository/to/image.svg" width="128"/>
示例（假设图像在存储库的assets 目录中）：
结果：
【讨论】：
然后复制图片源
现在将  添加到您的 README.md 文件中
完成！
或者，您可以使用一些图像托管网站，例如 imgur，并获取它的 url 并将其添加到您的 README.md 文件中，或者您也可以使用一些静态文件托管。
【讨论】：
只需将<img> 标记添加到您的 README.md 中，并在您的存储库中添加相对 src。如果您不使用相对 src，请确保服务器支持 CORS。
它之所以有效是因为 GitHub 支持 inline-html
<img src="/docs/logo.png" alt="My cool logo"/>
# My cool project and above is the logo of it
关注here
【讨论】：
您现在可以在编辑自述文件时拖放图像。
Github 会为你创建一个链接，格式如下：
https://user-images.githubusercontent.com/******/********.file_format
或者，在文件底部显示“通过拖放、选择或粘贴附加文件”。如果你点击那个，它会给你一个直接上传文件的选项，或者你可以直接粘贴它！
【讨论】：
一步一步的过程， 首先创建一个文件夹（命名您的文件夹）并在 Readme.md 文件中添加您要上传的图像/图像。 （您还可以在项目的任何现有文件夹中添加图像/图像。） 现在，点击Readme.md文件的编辑图标，然后
 // refrence_image is the name of image in my case.
添加图片后，您可以在“预览更改”选项卡中看到更改的预览。您将在此处找到您的图片。 例如像这样， 就我而言，
app 文件夹 -> src 文件夹 -> 主文件夹 -> res 文件夹 -> drawable 文件夹 -> 并在 drawable 文件夹中找到 refrence_image.png 文件。 要添加多个图像，您可以这样做，
注意 1 - 确保您的图像文件名不包含任何空格。如果它包含空格，那么您需要为文件名之间的每个空格添加 %20。最好去掉空格。
注意 2 - 您甚至可以使用 HTML 标记调整图像大小，或者还有其他方法。你可以用谷歌搜索更多。 如果你需要的话。
在此之后，编写您的提交更改消息，然后提交您的更改。
还有很多其他的技巧，比如创建问题等等。到目前为止，这是我遇到的最好的方法。
【讨论】：
用桌子脱颖而出，别具一格的魅力
表格语法是：
用符号|分隔每一列单元格
表头（第一行）第二行---
|第 1 列 |第 2 列 |
|------------|----------------|
|图片 1 |图 2 |
输出
如果您使用两张图片，现在只需将<img src="url/relativePath"> 放在图片 1 和图片 2 上
注意：如果使用多张图片只是包含更多的列，您可以使用 width 和 height 属性使其看起来可读。
示例
|第 1 列 |第 2 列 |
|------------|----------------|
| <img src="https://media.wired.com/photos/5926db217034dc5f91becd6b/master/w_582,c_limit/so-logo-s.jpg" width="250"> | <img src="https://mk0jobadderjftub56m0.kinstacdn.com/wp-content/uploads/stackoverflow.com-300.jpg" width="250"> |
间距无关紧要
输出图像
帮助：adam-p
【讨论】：
你可以使用
![A test image] 是您的替代文字，(image.png) 是图片的链接。
您可以将图像放在云服务或其他在线图像托管平台上 或者，如果它在存储库中，您可以提供存储库中的图像链接
您还可以在存储库中创建一个专用于自述文件图像的特定文件夹
【讨论】：
在新的 Github UI 中，这对我有用 -
示例 - 在文件夹 (myFolder) 中提交您的 image.png 并在您的 README.md 中添加以下行：
【讨论】：
你可以这样做：
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 文件中引用它：
【讨论】：
就是这样！
注意标签中的文件名大写，并将PNG文件放入根目录，并链接到文件名而不带任何路径：
【讨论】：
这里的大多数答案直接或间接涉及将图像上传到其他地方然后提供指向它的链接。
只需复制任何图像并在编辑 Readme.md 时将其粘贴即可完成
Ctrl + C 或使用截图工具将截图图片复制到剪贴板Ctrl + V
Guithub 会自动将其上传到 user-images.githubusercontent.com 并在其中插入指向它的链接
【讨论】：
我通常在网站上托管图片，这可以链接到任何托管图片。把这个扔到自述文件中。适用于.rst 文件，不确定.md
.. image:: https://url/path/to/image
:height: 100px
:width: 200 px
:scale: 50 %
【讨论】：
就我而言，我使用imgur 并以这种方式使用直接链接。
【讨论】：
您可以使用备用 github CDN 链接从 README.md（或外部）链接到项目中的图像。
网址将如下所示：
https://cdn.rawgit.com/<USER>/<REPO>/<BRANCH>/<PATH>/<TO>/<FILE>
我的项目中有一个 SVG 图像，当我在 Python 项目文档中引用它时，它没有呈现。
这是文件的项目链接（不渲染为图像）：
https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg
嵌入图片示例：
这是文件的 RAW 链接（仍然不呈现为图像）：
https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg
嵌入图片示例：
使用 CDN 链接，我可以使用（呈现为图像）链接到文件：
https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg
嵌入图片示例：
这就是我能够在我的 README.md 文件和我的 PyPi 项目 reStructredText doucmentation (here) 中使用我项目中的图像的方式
【讨论】：
有两种简单的方法可以做到这一点，
1) 使用 HTML img 标签，
2) 
当您打开该图像时，您可以从浏览器中的 URL 复制路径。 可能会出现间距问题，因此请确保两个单词路径或图像名称 add-> %20 中是否有空格。就像浏览器一样。
两者都可以，如果你想了解更多可以查看我的 github -> https://github.com/adityarawat29
【讨论】：
此答案也可以在以下位置找到： https://github.com/YourUserAccount/YourProject/blob/master/DirectoryPath/ReadMe.md
?sanitize=true&raw=true
<img />标签raw.githubusercontent.com/
YourUserAccount/
YourProject/
YourBranch/
DirectoryPath/
example.png
适用于 SVG、PNG 和 JPEG
- `raw.githubusercontent.com/YourUserAccount/YourProject/YourBranch/DirectoryPath/svgdemo1.svg?sanitize=true&raw=true`
使用后的工作示例代码如下所示：
**raw.githubusercontent.com**:
<img src="https://raw.githubusercontent.com/YourUserAccount/YourProject/master/DirectoryPath/Example.png?raw=true" />
<img src="https://raw.githubusercontent.com/YourUserAccount/YourProject/master/DirectoryPath/svgdemo1.svg?sanitize=true&raw=true" />
raw.githubusercontent.com：
谢谢： - https://stackoverflow.com/a/48723190/1815624 - https://github.com/potherca-blog/StackOverflow/edit/master/question.13808020.include-an-svg-hosted-on-github-in-markdown/readme.md
【讨论】：
在我的例子中，我想在Github 和NPM 上显示一个打印屏幕。即使使用相对路径在Github 内工作，它也不能在它之外工作。基本上，即使我也将我的项目推送到NPM（它只是使用相同的readme.md，图像从未显示。
我尝试了几种方法，最后这对我有用：
我现在可以在 NPM 或其他任何我可以发布我的包的地方正确地看到我的图像。
【讨论】：
如果您需要上传一些图片作为文档，一个不错的方法是使用git-lfs。假设您已经安装了 git-lfs，请按照以下步骤操作：
为您的每种图像类型初始化 git lfs：
git lfs *.png
git lfs *.svg
git lfs *.gif
git lfs *.jpg
git lfs *.jpeg
创建一个将用作图像位置的文件夹，例如。 doc。在基于 GNU/Linux 和 Unix 的系统上，这可以通过以下方式完成：
cd project_folder
mkdir doc
git add doc
将所有图像复制粘贴到 doc 文件夹中。然后通过git add 命令添加它们。
提交并推送。
图片可在以下网址公开获取：
https://media.githubusercontent.com/media/^github_username^/^repo^/^branch^/^repo 中的image_location^
在哪里：
* ^github_username^ 是github中的用户名（可以在个人资料页面找到）
* ^repo_name^ 是存储库名称
* ^branch^是图片上传的仓库分支
* ^image_location in the repo^ 是包含图片所在文件夹的位置。
您也可以先上传图片，然后访问项目 github 页面中的位置并导航，直到找到图片，然后按 download 按钮，然后从浏览器的地址栏中复制粘贴 url。
从我的项目中查看this 作为参考。
然后你可以使用上面提到的markdown语法使用url来包含它们：
例如：假设我们使用this photo 那么你可以使用markdown语法：
【讨论】：
我只是在已接受的答案中扩展或添加示例。
将图像放入 Github 存储库后。
然后：
我的情况是
在哪里
shadmazumder 是我的username
Xcode 是 projectname
master 是 branch
InOnePicture.png 是 image，在我的情况下，InOnePicture.png 在根目录中。【讨论】：
Wiki 可以显示 PNG、JPEG 或 GIF 图像
现在你可以使用了：
[[https://github.com/username/repository/blob/master/img/octocat.png|alt=octocat]]
-或-
按照以下步骤操作：
在 GitHub 上，导航到存储库的主页。
在您的存储库名称下，单击 Wiki。
使用 wiki 侧边栏，导航到要更改的页面，然后单击编辑。
在 wiki 工具栏上，点击图片。
在“插入图片”对话框中，输入图片网址和替代文本（搜索引擎和屏幕阅读器使用）。
点击确定。
请参考Docs。
【讨论】：