This lesson is still being designed and assembled (Pre-Alpha version)

Adding Links and Images


Teaching: 0 min
Exercises: 0 min
  • How does one add a link?

  • How does one add an image?

  • How does one add an image that is also a link?

  • Adding links and images.

Links are created by using square brackets around the text to be displayed, followed by round brackets for the link to be used. For example, to create a link to the GitHub website we can do this:

[GitHub Website](

This will be displayed as:

Github Website.


To add an image the MarkDown is similar to that of a link but a ! is added to the front, eg.

![alt text]( "Carpentries Logo")

That should result in:

Carpentries Logo

As you can, the above link references and images that is in another repository. If you uploaded the image to your local repository, you only need to specify the name. If it is in a sub-directory below your Markdown file it is referenced in a relative way, eg.

![Double helix](fig/DNA_double_helix_horizontal.png)

Double helix

Image Credit: By Jerome Walker - Own work, created from GDFL work created by Michael Ströck, Public Domain,

Key Points

  • Use [] and () to add images and links