How to Embed a Screenshot in Markdown (README, GitHub, Docs)

Markdown does not let you paste an image directly — it needs a URL that points at the image file. So the real question is how to turn a screenshot on your machine into a link you can drop into the ![](url) syntax. Here is the fastest way.

Step 1 — get a direct image link

Open the screenshot-to-link tool and paste your screenshot with Ctrl/Cmd + V, or drag the file onto the box. You get back two links; the one you want here is the direct image link, which points straight at the image with no page around it.

Step 2 — write the Markdown

Use the image syntax, with your direct link inside the parentheses:

  • ![Alt text describing the image](https://sshot.online/f/aB3xQ9k.png)

The text in the square brackets is the alt text — keep it descriptive, since it shows if the image fails to load and helps accessibility.

Where this works

  • GitHub — README files, issues, pull request descriptions, and comments.
  • Documentation — MkDocs, Docusaurus, GitBook, and most static-site generators.
  • Wikis & forums — anything that renders standard Markdown.

Because the link is a plain image URL with no interstitial page, it also works in raw HTML with an <img> tag if you need it. Need to share the image with people instead of embedding it? Use the share link from the same upload.

← All posts