Customise Consent Preferences

We use cookies to help you navigate efficiently and perform certain functions. You will find detailed information about all cookies under each consent category below.

The cookies that are categorised as "Necessary" are stored on your browser as they are essential for enabling the basic functionalities of the site. ... 

Always Active

Necessary cookies are required to enable the basic features of this site, such as providing secure log-in or adjusting your consent preferences. These cookies do not store any personally identifiable data.

No cookies to display.

Functional cookies help perform certain functionalities like sharing the content of the website on social media platforms, collecting feedback, and other third-party features.

No cookies to display.

Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics such as the number of visitors, bounce rate, traffic source, etc.

No cookies to display.

Performance cookies are used to understand and analyse the key performance indexes of the website which helps in delivering a better user experience for the visitors.

No cookies to display.

Advertisement cookies are used to provide visitors with customised advertisements based on the pages you visited previously and to analyse the effectiveness of the ad campaigns.

No cookies to display.

  1. Home
  2. Knowledge Base
  3. Annotating with Hypothesis
  4. Formatting Annotations with Markdown

Formatting Annotations with Markdown

The Hypothesis editor supports formatting your annotations using Markdown — this help article serves as a “cheat sheet” for using Markdown syntax in the annotation editor.

Also see our articles on adding links and images, embedding videos, and formatting annotations using LaTeX.

Want to print this sheet out? Here’s a printable PDF.

Style Syntax Example Result
Headings # H1

## H2

### H3

# Largest heading 

## Smaller heading 

### Even smaller

Largest heading

Smaller heading

Even smaller

Bold **text** or __text__
**This text is bold**
This text is bold
Italic *text* or _text_
*This text is italicized*
This text is italicized
Strikethrough ~~text~~
~~This text has been struck through~~
This text has been struck through
Blockquote > quoted text
Here’s a quote:
> quoted text
Here’s a quote:

quoted text

Ordered list 1. First item
2. Second item
3. Third item
Favorite colors:
1. Blue
2. Purple
3. Green
Favorite colors:

  1. Blue
  2. Purple
  3. Green
Unordered list – First item

– Second item

– Third item

Grocery list:
- Coffee
- Tea
- Milk
Grocery list:

  • Coffee
  • Tea
  • Milk
Inline code `code`
Run `make dev` to start the server
Run make dev to start the server
Horizontal rule
---
Starting a new section

---

(notice the empty line between the text and horizontal rule)

Starting a new section


Previewing your annotation

You can click “Preview” in the annotation editor toolbar to see what your formatted annotation will look like:

…and you can click “Write” to continue editing your annotation:

Troubleshooting annotation formatting

  • If you are copying annotation text from another source (Microsoft Word, Google Docs, etc), paste the text without formatting. You can do this with Option+Shift+Command+V for Macs or Ctrl+Shift+V for PCs.
  • Ensure there is an empty line between paragraph text and horizontal rules.
  • Experiment with hitting Enter or Return once vs. twice if you encounter line break issues.
  • Consult the GitHub Flavored Markdown spec or create a ticket to get help from the Hypothesis team.
Was this article helpful?

Related Articles