GitLab Markdown Cheat Sheet

You can add task lists to issues, merge requests and comments. To create a task list, add a specia­lly­-fo­rmatted Markdown list, like so:

- [x] Completed task
- [ ] Incomplete task
 ­ - [ ] Sub-task 1
 ­ - [x] Sub-task 2
 ­ - [ ] Sub-task 3

Task lists can only be created in descri­ptions, not in titles. Task item state can be managed by editing the descri­pti­on's Markdown or by toggling the rendered check boxes.

Headers
# H1
## H2
### H3
#### H4
##### H5
###### H6

Altern­ati­vely, for H1 and H2, an underl­ine-ish style:

Alt-H1
======

Alt-H2
------

Emphasis
Emphasis, aka italics, with *aster­isks* or _under­sco­res_.

Strong emphasis, aka bold, with **aste­risks** or __unde­rsc­ores__.

Combined emphasis with **aste­risks and _under­sco­res_**.

Strike­through uses two tildes. ~~Scratch this.~~

Lists
1. First ordered list item
2. Another item
 ­  Unordered sub-list.
1. Actual numbers doesn't matter, just that it's a number
 ­ 1. Ordered sub-list
4. And another item.

Unordered list can use asterisks
- Or minuses
+ Or pluses

Links
There are two ways to create links, inline­-style and refere­nce­-style.

inline link
[reference link][­Arb­itrary reference text]
relative reference to a repo file
[numbers for reference link defini­tio­ns][1]
Or leave it empty [link text itself][]

Some text to show that the reference links can follow later.

[arbitrary reference text]: https:­//w­ww.m­oz­ill­a.org
[1]: http:/­/sl­ash­dot.org
[link text itself]: http:/­/ww­w.r­edd­it.com

Images
Here's our logo (hover to see the title text):

Inline­-style:
!alt text

Refere­nce­-style:
![alt text1]­[logo]

[logo]: assets­/lo­go-­whi­te.png

Blockq­uotes
> Blockq­uotes are very handy in email to emulate reply text.
> This line is part of the same quote.

Quote break.

> This is a very long line that will still be quoted properly when it wraps. Oh boy let's keep writing to make sure this is long enough to actually wrap for everyone. Oh, you can put Markdown into a blockq­uote.

Tables
| header 1  | header 2  |
| -------- | -------- |
| cell 1  ­ ­ ­ ­  | cell 2  ­ ­ ­ ­ ­  |
| cell 3  ­ ­ ­ ­  | cell 4        |

| Left Aligned  ­ | Centered | Right Aligned   |
| :-----­------ | :------: | ------­------: |
| Cell 1  ­ ­ ­ ­ ­ ­ ­ ­ ­ ­  | Cell 2  ­ ­ ­  | Cell 3  ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ |