Add image with link in Github's README.md? - github

How to add an image that is also a link to an external page on Github's README.md?
Adding a markdown to display an image is pretty simple (answer at Add images to README.md on GitHub). Adding a link is also pretty simple (GitHub relative link in Markdown file), but it seems there's is no way to add an image that is also a link to an external site.
<img src="RELATIVE_PATH_TO_IMAGE></img>

Try simply the syntax:
[![name](link to image on GH)](link to your URL)
That will wrap the image as a link

Some additional syntax mixing html and markdown, giving you more flexibility in adjusting how image is displayed.
Assuming you have repo structure as follows (it just refers to relative link used in syntax below):
example repo structure
you can use
[<img alt="alt_text" width="40px" src="images/image.PNG" />](https://www.google.com/)

Structure:
[![name](link to image on GH)](link to your URL)
Example:
![image search api](https://user-images.githubusercontent.com/110724391/184472398-c590b47c-e1f2-41f8-87e6-2a1f68e8850d.png)[(Youtube)](https://www.youtube.com/watch?v=3HIr0imLgxM)

The people who wrote the previous answers were overcomplicating it. This works in Markdown+HTML5 and is easy to understand when looking at the source code.
The code: [<img src="img/myImage.png">](http://example.com/),
where img/myImage.png should be replaced by the relative path to your image, and http://example.com/ should be replaced by the link you want to visit when the image is clicked.

Related

How to add an image to github ReadMe.md file

I have tries all the below and the image does not seems to be appearing on my read me file. I've added the image under the issues as someone suggested but nothing. also tried numerous other methods but the image does not want to appears and on the video tutorials i'm doing line by line but nothing.
link to the isssues:
https://user-images.githubusercontent.com/89415628/185356092-4229772b-1852-4ee0-9daa-043ff87a2080.png
using the img tag with the image that are in the root folder
<img src="https://github.com/Opzalas/CMPG-323-Overview---33448809/blob/main/branching.png?raw=true">
The most used method to add image to read me file with image under the issues
![](https://github.com/Opzalas/CMPG-323-Overview---33448809/blob/main/assets/images/89415628/185356092-4229772b-1852-4ee0-9daa-043ff87a2080.png?raw=true)
image stored on the root repo with image link
![](https://github.com/Opzalas/CMPG-323-Overview---33448809/blob/main/branching.png)
** Image with the root directory**
![](branching.png)
What is funny is that it is working within stack overflow but not on github with the img tag with root directory.
Answer provided in #Benjamin W's comment; thank you, much appreciated. Please see answer below:
I took a look at your file, and the problem is that your text blocks are indented. In Markdown, that means "code block", where everything is interpreted literally. You have to un-indent them. I have created a PR to show you how.

Add an image to Github Readme file

I am trying to add an image to a Github ReadmE file and have found the same answers several times on different places, the only thing is that it doesn't work for me. I tried 2 methods, first is to upload to a site and add it to Readme like this:
![Image](https://pasteboard.co/JAJAuBP.png)
Which is the answer here. However, this just gives me this as result, where the link doesn't even go to my picture:
I also tried the method of putting the picture in a github folder in my project as described here, like this:
![alt text](https://github.com/eligolf/affinity_chess/tree/main/imgs/gui_image.png?raw=true)
By clicking the link I do get to the folder where my image is located, but the image itself won't show in the Readme. It just shows the same broken image icon as the first method. Removing the ?raw=true had no effect.
Why is this so hard? Can someone please let me know how to add an image to Github.

Change size of image in github flavored markdown without using HTML img tag?

I am limited to using []() syntax to render an image (as opposed to <img>) (the reason for this limitation is because it's currently being used as a workaround for a known bug).
Is there a way to resize an image using only []() convention (not using <img>)?
I have tried some things so far that haven't worked. Most notably:
Adding ?s=200/&s=200 parameter to the end of the image url (recommended here)
The best solution I have so far is to download the image and resize it and re-upload it. Any way of changing its size from the md itself or by way of changing the url (e.g. via a parameter etc) would be much better
The GFM (GitHub Flavored Markdown) specification for images does not include any size attributes.
Meaning a []() won't include any size element in its HTML generated form.
If you change the Markdown processor to Kramdown for GitHub pages, then this would work:
![test image size](/img/post-bg-2015.jpg){:class="img-responsive"}
![test image size](/img/post-bg-2015.jpg){:height="50%" width="50%"}
![test image size](/img/post-bg-2015.jpg){:height="700px" width="400px"}
Using HTML would work (provided you use the https://raw.githubusercontent.com/ of your image, but this is not possible in your case.
<img src="https://your-image-url.type" width="100" height="100">
You can try, for testing:
{:refdef: style="width: 10px; height: 10px"}
[![Octocat](https://github.githubassets.com/images/icons/emoji/octocat.png)](./somelink)
{: refdef}

How to resize an image with clickable link in README.md file?

I have been trying to add a link to one of the YouTube videos in the README.md file. So, first I took a screenshot of the video at a specific timestamp, put it in the local directory, and then used the following syntax:
[![ALT TEXT] (image/screenshot path)] (https://youtu.be/video_id "video text")
But as the size of the screenshot is a little big (as big as my laptop screen), using the above syntax takes a lot of space in the output! I don't want that. I want to control the size of the screenshot/image. How can I do that?
I found different answers on adding an image with a clickable link; resize an image in readme; but I couldn't find any answer addressesing both the issues. (Sorry if such answer already exists)
Thanks a lot in advance :)
You can include raw HTML in your Markdown document, so just use standard HTML <a> and <img> tag with width and height atttributes:
<img src="path/to/img.png" width="xxx" height="yyy">
This will render correctly on github and elsewhere.

Big gif from a third party site does not show in the README.md of github?

I want to show a gif in a README.md of github.
And it works fine when the target gif is small with:
<img src="targetGifUrl" width="400">
but when the gif is big, it is not showing as expected, take this gif as an example. When I add it into README.md, it just shows:
and after clicking, it shows a website with the tip
Content length exceeded
As the gif is from a third site, I can not change its size.
So, is it possible to show this big gif without saving and resizing it?
It looks like someone else had this issue before,
When I open this link in Firefox, I only get the text "Content length exceeded".
and here is the commit that fixed it.
Add gif locally
-![Sample Gif](http://i.imgur.com/______.gif)
+<img src="/art/sample.gif?raw=true" width="200px">
Looks like all you have to do is save the gif and put it in your repository, no need to resize it, just link to the version in your repository. Notice how the width is specified and raw=true is an included parameter.
Put Gif files in the local directory on your git repo. Then call it in readme file.
For example, If you just created a folder called demo in the root directory and put demo.gif inside it. Then you can call that in your readme file like this.
![Demo File](https://github.com/username/repo-name/blob/master/demo/demo.gif)
Eg:
![Screenshot](https://github.com/codemaker2015/React-native-map-view/blob/master/demo/demo.gif)