Links & Images in Markdown

Interactive Markdown tutorial on links and images: inline links, titled links and embedded pictures. Edit the live example and see the result instantly in your browser.

Two of Markdown’s most-used features point outward: links to other pages and images embedded in your text. Both share the same bracket-and-parenthesis shape.

Links

Write the visible text in square brackets, then the URL in parentheses:

[Rverse Analytics](https://rverseanalytics.com)

You can add a hover title in quotes after the URL: [text](https://example.com "Title shown on hover").

Images

An image is a link with a ! in front. The text in brackets becomes the alt text (shown if the image can’t load, and read by screen readers), and the parentheses hold the image path:

![A scatter plot of the results](results.png)

Edit the example below — try changing the link text, the URL, and the alt text:

You write ## Useful links Read the [R project home page](https://www.r-project.org "The R website"). Our free [statistics calculators](https://rverseanalytics.com/tools.html) run in the browser. ## An image 

You get

Notice how the link text is what you see, while the URL stays hidden behind it — and how the image’s alt text describes the picture. Always write meaningful alt text: it’s important for accessibility and SEO.

---

Next: Code & quotes → — showing code and quoting sources.