Recently I joined GitHub. I hosted some projects there.
I need to include some images in my README File. I don't know how to do that.
I searched about this, but all I got was some links which tell me to "host images on web and specify the image path in README.md file".
Is there any way to do this without hosting the images on any third-party web hosting services?
This question is related to
github
markdown
github-flavored-markdown
readme
In my case i use imgur and use the direct link this way.
![img](http://i.imgur.com/yourfilename.png)
In my case I wanted to show a print screen on Github
but also on NPM
. Even though using the relative path was working within Github
, it wasn't working outside of it. Basically, even if I pushed my project to NPM
as well (which simply uses the same readme.md
, the image was never showing.
I tried a few ways, at the end this is what worked for me:
![Preview](https://raw.githubusercontent.com/username/project/master/image-path/image.png)
I now see my image correctly on NPM
or anywhere else that I could publish my package.
Consider using a table
if adding multiple screenshots and want to align them using tabular data for improved accessibility as shown here:
If your markdown parser supports it you could also add the role="presentation"
WIA-ARIA attribute to the TABLE element and omit the th
tags.
You can just do:
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
Then you can just reference it in the README
file like so:
![diagram](diagram.png)
I have found another solution but quite different and i'll explain it
Basically, i used the tag to show the image, but i wanted to go to another page when the image was clicked and here is how i did it.
<a href="the-url-you-want-to-go-when-image-is-clicked.com" />
<img src="image-source-url-location.com" />
If you put it right next to each other, separated by a new line, i guess when you click the image, it goes to the tag which has the href to the other site you want to redirect.
This Answer can also be found at: https://github.com/YourUserAccount/YourProject/blob/master/DirectoryPath/ReadMe.md
?sanitize=true&raw=true
<img />
tagraw.githubusercontent.com/
YourUserAccount/
YourProject/
YourBranch/
DirectoryPath/
example.png
Works for SVG, PNG, and JPEG
- `raw.githubusercontent.com/YourUserAccount/YourProject/YourBranch/DirectoryPath/svgdemo1.svg?sanitize=true&raw=true`
Working example code displayed below after used:
**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:
Thanks: - 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
You can also use relative paths like
![Alt text](relative/path/to/img.jpg?raw=true "Title")
Also try the following with the desired .fileExtention
:
![plot](./directory_1/directory_2/.../directory_n/plot.png)
Step by step process, First create a folder ( name your folder ) and add the image/images that you want to upload in Readme.md file. ( you can also add the image/images in any existing folder of your project. ) Now,Click on edit icon of Readme.md file,then
![](relative url where images is located/refrence_image.png) // refrence_image is the name of image in my case.
After adding image, you can see preview of changes in the, "Preview Changes" tab.you will find your image here. for example like this, In my case,
![](app/src/main/res/drawable/refrence_image.png)
app folder -> src folder -> main folder -> res folder -> drawable folder -> and inside drawable folder refrence_image.png file is located. For adding multiple images, you can do it like this,
![](app/src/main/res/drawable/refrence_image1.png)
![](app/src/main/res/drawable/refrence_image2.png)
![](app/src/main/res/drawable/refrence_image3.png)
Note 1 - Make sure your image file name does not contain any spaces. If it contain spaces then you need to add %20 for each space between the file name. It's better to remove the spaces.
Note 2 - you can even resize the image using HTML tags, or there are other ways. you can google it for more. if you need it.
After this, write your commit changes message, and then commit your Changes.
There are many other hacks of doing it like, create a issue and etc and etc. By far this is the best method that I have came across.
In case you need to upload some pictures for documentation, a nice approach is to use git-lfs. Asuming that you have installed the git-lfs follow these steps:
Intialize git lfs for your each image type:
git lfs *.png
git lfs *.svg
git lfs *.gif
git lfs *.jpg
git lfs *.jpeg
Create a folder that will be used as image location eg. doc
. On GNU/Linux and Unix based systems this can be done via:
cd project_folder
mkdir doc
git add doc
Copy paste any images into doc folder. Afterwards add them via git add
command.
Commit and push.
The images are publicly available in the following url:
https://media.githubusercontent.com/media/^github_username^/^repo^/^branch^/^image_location in the repo^
Where:
* ^github_username^
is the username in github (you can find it in the profile page)
* ^repo_name^
is the repository name
* ^branch^
is the repository branch where the image is uploaded
* ^image_location in the repo^
is the location including the folder that the image is stored.
Also you can upload the image first then visit the location in your projects github page and navigate through until you find the image then press the download
button and then copy-paste the url from the browser's address bar.
Look this from my project as reference.
Then you can use the url to include them using the markdown syntax mentioned above:
![some alternate text that describes the image](^github generated url from git lfs^)
Eg: Let us suppose we use this photo Then you can use the markdown syntax:
![In what order to compile the files](https://media.githubusercontent.com/media/pc-magas/myFirstEnclave/master/doc/SGX%20Compile%20workflow.png)
There are 2 simple way you can do this ,
1) use HTML img tag ,
2) ![](the path where your image is saved/image-name.png)
the path would you can copy from the URL in the browser while you have opened that image. there might be an issue occur of spacing so make sure if there is any space b/w two words of path or in image name add-> %20. just like browser do.
Both of them will work , if you want to understand more you can check my github -> https://github.com/adityarawat29
Just add an <img>
tag to your README.md with relative src to your repository. If you're not using relative src, make sure the server supports CORS.
It works because GitHub support inline-html
<img src="/docs/logo.png" alt="My cool logo"/>
# My cool project and above is the logo of it
Observe here
JUST THIS WORKS!!
take care about your file name uppercase in tag and put PNG file inroot, and link to the filename without any path:
![Screenshot](screenshot.png)
We can do this simply,
div
of Issueafter a few seconds, a link will be generated. Now, copy the link or image URL and use it any supported platform.
You can link to images in your project from README.md (or externally) using the alternative github CDN link.
The URL will look like this:
https://cdn.rawgit.com/<USER>/<REPO>/<BRANCH>/<PATH>/<TO>/<FILE>
I have an SVG image in my project, and when I reference it in my Python project documentation, it does not render.
Here is the project link to the file (does not render as an image):
https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg
Example embedded image:
Here is the RAW link to the file (still does not render as an image):
https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg
Example embedded image:
Using the CDN link, I can link to the file using (renders as an image):
https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg
Example embedded image:
This is how I am able to use images from my project in both my README.md
file, and in my PyPi project reStructredText doucmentation (here)
Add image in your repository from upload file option then in README file
![Alt text]("enter repository image URL here")
In new Github UI, this works for me -
Example - Commit your image.png in a folder (myFolder) and add the following line in your README.md:
![Optional Text](../main/myFolder/image.png)
You can also add images with simple HTML tags:
<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>
Many of the posted solutions are incomplete or not to my taste.
My preferred solution, inspired by this gist, is to use an assets branch with permalinks to specific revisions.
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.
Construct a "permalink" to this revision of the image, and wrap it in Markdown.
Looking up the commit SHA by hand is inconvenient, however, so as a shortcut press Y to a permalink to a file in a specific commit as this help.github page says.
To always show the latest image on the assets branch, use the blob URL:
https://github.com/github/{repository}/blob/assets/cat.png
(From the same GitHub help page File views show the latest version on a branch)
Just upload your image to the repository root, and link to the filename without any path, like so:
![Screenshot](screenshot.png)
here is a detailed youTube video explained this in detail:
Commit your image (image.png) in a folder (myFolder) and add the following line in your README.md:
![Optional Text](../master/myFolder/image.png)
I need to include some images in my README File. I don't know how to do that.
I created a small wizard that allows you to create and customize simple image galleries for your GitHub repository's readme: See ReadmeGalleryCreatorForGitHub.
The wizard takes advantage of the fact that GitHub allows img tags to occur in the README.md
. Also, the wizard makes use of the popular trick of uploading images to GitHub by drag'n'dropping them in the issue area (as already mentioned in one of the answers in this thread).
Then copy image source
Now add ![alt tag](http://url/to/img.png)
to your README.md file
Done!
Alternatively you can use some image hosting site like imgur
and get it's url and add it in your README.md file or you can use some static file hosting too.
I usually host the image on the site, this can link to any hosted image. Just toss this in the readme. Works for .rst
files, not sure about .md
.. image:: https://url/path/to/image
:height: 100px
:width: 200 px
:scale: 50 %
Wikis can display PNG, JPEG, or GIF images
Now you can use:
[[https://github.com/username/repository/blob/master/img/octocat.png|alt=octocat]]
-OR-
Follow these steps:
On GitHub, navigate to the main page of the repository.
Under your repository name, click Wiki.
Using the wiki sidebar, navigate to the page you want to change, and then click Edit.
On the wiki toolbar, click Image.
In the "Insert Image" dialog box, type the image URL and the alt text (which is used by search engines and screen readers).
Click OK.
Refer Docs.
Use tables to stand out, it will give separate charm to it
Table Syntax is:
Separate each column cell by symbol |
and table header (First row) by 2nd row by ---
| col 1 | col 2 |
|------------|-------------|
| image 1 | image 2 |
output
Now just put <img src="url/relativePath">
at image 1 and image 2 if you are using two images
Note: if using multiple images just include more columns, you may use width and height attribute to make it look readable.
Example
| col 1 | col 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">
|
Spacing does not matter
Output image
helped by : adam-p
I am just extending or adding an example to the already accepted answer.
Once you have put the image on your Github repo.
Then:
![alt text](https://raw.githubusercontent.com/username/projectname/branch/path/to/img.png)
On my case it is
![In a single picture](https://raw.githubusercontent.com/shadmazumder/Xcode/master/InOnePicture.png)
Where
shadmazumder
is my username
Xcode
is the projectname
master
is the branch
InOnePicture.png
is the image
, On my case InOnePicture.png
is in the root directory.There's yet another option I haven't seen mentioned. You can simply create another repository under your user or organization called "assets". Push your images to this repo and reference them from your other repos:
![alt text](https://raw.githubusercontent.com/my-org/assets/master/folder/logo.png)
I've done this in one of my repos and it suits me fine. I can version my README images for all of my projects independently of my code, but still keep them all in one place. No issues or branches or other easily misplaced artifacts required.
If you want to show an image hosted at any website (say url is "http:// abc.def.com/folder/image.jpg
") then in your README.md
file use the below syntax:
![alt text](<http:// abc.def.com/folder/image.jpg>)
For images hosted in your own github repository you can use relative path in addition to the above url format
![alt text](<path_relative_to_current_github_location/image.jpg>)
README.md
file (special case of relative path url), then you can use:![alt text](<image.jpg>)
Note the angular brackets "<" and ">" enclosing the url. Sometimes these are required for the url to work.
Source: Stackoverflow.com