Adding Links, Images, and Videos to Your Annotations in Hypothesis
The Hypothesis editor allows you to include links, images, and videos in your annotations.
Also see our articles on using Markdown, and formatting annotations using LaTeX.
Adding links
Copy a URL that you would like to include in your annotation.
In the Hypothesis client text editor, select some text in your annotation and click on the link button.
The Hypothesis text editor will put square brackets around the words you have selected and will add
(http://insert-your-link-here.com)
next it. Replace the http://insert-your-link-here.com
with the URL you copied in Step 1, making sure to leave the parentheses.
Save your annotation to see your hyperlink in red underlined text.
Adding images
Hypothesis allows you to embed images that are already hosted on the web – if you have an image saved locally, you’ll need to upload it to a site like Imgur. Then, you can follow the steps below (Note: this works for animated GIFs as well!):
Copy the URL of the image. One way to do this is to right-click (Control-Click on a PC or ⌘-Click on a Mac) an image and select “Copy Image Address” from the context menu:
Return to the Hypothesis sidebar and click on the image button in the text editor. The following bit of code will appear:
![](http://insert-your-link-here.com)
Replace the
http://insert-your-link-here.com
with the image URL you copied in Step 1, making sure to leave the parenthesis.
Add an image description in between the square brackets. This will help blind and low-vision users, and is a best practice for using images on the web. For information on how to write good image descriptions, see this
blog post from the Stanford Web Services Blog.
Save your annotation to confirm that the image has been embedded properly.
Adding videos
You can link to videos hosted anywhere on the web by following the steps above for adding a link, but you can also embed Youtube, Vimeo, and Flipgrid videos directly into your annotations! Copy the video URL and paste it into the annotation text editor:
Save your annotation and the video will be embedded automatically, meaning you and others can play the video directly within the annotation sidebar.