如果您需要上传一些图片用于文档，一个不错的方法是使用git-lfs。假设您已安装git-lfs，请执行以下步骤：

初始化每个图像类型的git-lfs：数字lfs*.png数字lfs*.svg数字lfs*.gifgit-lfs*.jpggit-lfs*.jpeg创建一个将用作图像位置的文件夹，例如doc。在基于GNU/Linux和Unix的系统上，这可以通过以下方式完成：cd项目文件夹mkdir文档git添加文档复制粘贴任何图像到文档文件夹。然后通过gitadd命令添加它们。提交并推送。图片可在以下url中公开获取：https://media.githubusercontent.com/media/^github_username^/^repo^/^branch^/^image_location在repo中^

哪里：*^github_username^是github中的用户名（您可以在配置文件页面中找到）*^repo_name^是存储库名称*^branch^是上载图像的存储库分支*^image_location in the repo ^是包含存储图像的文件夹的位置。

此外，您还可以先上传图像，然后访问项目github页面中的位置并浏览，直到找到图像，然后按下下载按钮，然后从浏览器的地址栏复制粘贴url。

将我的项目作为参考。

然后，您可以使用上面提到的markdown语法使用url来包含它们：

![some alternate text that describes the image](^github generated url from git lfs^)

让我们假设我们使用这张照片，然后你可以使用markdown语法：

![In what order to compile the files](https://media.githubusercontent.com/media/pc-magas/myFirstEnclave/master/doc/SGX%20Compile%20workflow.png)

在我的例子中，我想在Github上显示打印屏幕，但也在NPM上显示。尽管使用相对路径在Github内部有效，但在Github之外却无法正常工作。基本上，即使我也将项目推到了NPM（它只是使用了相同的readme.md），图像也从未显示。

我尝试了几种方法，最后这对我有用：


我现在可以在NPM或任何其他我可以发布我的包的地方正确地看到我的图像。

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

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

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

我通常在网站上托管图像，这可以链接到任何托管图像。把这个放在自述文件里。适用于.rst文件，不确定.md

.. image:: https://url/path/to/image
   :height: 100px
   :width: 200 px
   :scale: 50 %

您可以使用

![A test image](image.png)

哪里[A test image]是您的alt文本，（image.png）是您图像的链接。

您可以将图像放在云服务或其他在线图像托管平台上或者，如果存储库中有图像链接，则可以从存储库中提供图像链接

您还可以在存储库中创建专用于自述文件图像的特定文件夹

用桌子突出，这会给它带来独特的魅力

表语法为：

按符号分隔每个列单元格|

表格标题（第一行）由第二行由---

|第1列|第2列||------------|-------------||图像1 |图像2|

输出

现在，如果使用两个图像，只需在图像1和图像2处放置<img src=“url/relativePath”>

注意：如果使用多个图像只是包含更多列，则可以使用width和height属性使其看起来可读。

实例

|第1列|第2列||------------|-------------||<img src=“https://media.wired.com/photos/5926db217034dc5f91becd6b/master/w_582，c_limit/so-go-s.jpg“width=”250“>|<img src=”https://mk0jobadderjftub56m0.kinstacdn.com/wp-content/uploads/stackoverflow.com-300.jpg“width=”250“>|

间距无关紧要

输出图像

帮助人：adam-p