Markdown Image Hosting: Images for GitHub READMEs, Docs and Notes

By Product Team

Upload a screenshot, diagram or GIF. You get Markdown ready to paste into a README, a wiki or your notes - free, no account, and the link doesn't expire.

Upload an Image

★ Rated 4.4/5 from 116 user ratings

Markdown shows an image from a link: ![alt text](image link). The image has to live somewhere on the web. YourImageShare hosts it for free and gives you the Markdown line ready to paste, for GitHub, GitLab, Obsidian, documentation sites or any other Markdown file.

Get Markdown for an Image

  1. Upload the image. Press Upload an Image, or on a computer paste a screenshot straight from the clipboard with Ctrl+V.
  2. Open the Markdown tab when the upload finishes and copy the code.
  3. Paste it into your file.

The Markdown tab gives a clickable image that opens the full-size picture:

[![AbC123xYz0](https://yourimageshare.com/ib/AbC123xYz0.png)](https://yourimageshare.com/ib/AbC123xYz0)

For a plain image without the link, keep only the inner part and give it real alt text:

![Settings screen](https://yourimageshare.com/ib/AbC123xYz0.png)

Images in GitHub READMEs, Issues and Wikis

GitHub shows external images in READMEs, issues, pull requests, discussions and wikis. Paste the Markdown code and the image appears when the page is rendered.

  • Set a size with an HTML tag, which GitHub allows in Markdown: <img src="https://yourimageshare.com/ib/AbC123xYz0.png" width="400" alt="Screenshot">
  • Demo GIFs keep playing in a README - see GIF hosting, or turn a screen recording into a GIF with the video to GIF converter.
  • Alt text describes the image for screen readers and shows if it can't load.

Obsidian, Notion and Documentation Sites

  • Obsidian, Typora, VS Code preview and other Markdown editors show the image from the link, so your notes stay small and the image works on every device.
  • Notion: type /image, choose Embed link and paste the direct link (the Direct tab).
  • Docs sites built with MkDocs, Docusaurus, Jekyll, Hugo or GitBook render the same Markdown image syntax.

Why Host Images Outside the Repository

  • Smaller repositories. Screenshots and GIFs add megabytes to every clone, forever, even after you replace them. A hosted image is only loaded when someone views the page.
  • Links don't expire. Images are kept until you delete them.
  • No account needed, and nothing to configure. For scripts and CI, there is a free upload API.
  • Full resolution and no watermark. EXIF data, including location, is removed before the image is stored.

Frequently Asked Questions

How do I add an image to a Markdown file?
Upload the image, copy the Markdown code from the Markdown tab and paste it into the file. Markdown shows an image with ![alt text](image link).
Can I use these images in a GitHub README?
Yes. GitHub shows external images in READMEs, issues, pull requests and wikis. Paste the Markdown code and the image appears when the file is rendered.
How do I set the size of an image in a README?
Plain Markdown has no size option. On GitHub, use an HTML image tag with a width, for example <img src="image link" width="400" alt="Screenshot">.
Why host README images outside the repository?
Screenshots and demo GIFs add megabytes to every clone of the repository. A hosted image is only loaded when someone views the README.
Do the image links expire?
No. Images are kept until you delete them, so links in documentation keep working.

More Use Cases

Ready to Add Your Image?