1. Home
  2. Help
  3. Tutorials and How-Tos
  4. Formatting Annotations with Markdown

When creating an annotation, you can use the toolbar above the text editor to add basic formatting along with links, images, equations, and YouTube videos. You can also format your annotations using Markdown— this help article serves as a “cheat sheet” for using Markdown syntax in the annotation editor.

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
---
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:

Was this article helpful?

Related Articles