---
description: "The three list types Jotaid supports — bullet, numbered and task — and nesting them with Tab."
---
<!--
  Markdown representation of https://docs.jotaid.com/en/guide/insert-lists
  Generated by scripts/gen-markdown-variants.mjs — do not edit by hand.
  Served from the canonical URL under `Accept: text/markdown`.
-->

# Insert Lists

Three kinds of list, all made from a few characters at the start of a line.

| List | Syntax | Shortcut |
|------|--------|----------|
| Bullet | `- item` (`*` and `+` work too) | ⌘⇧8 |
| Numbered | `1. item` | ⌘⇧7 |
| Task | `- [ ] todo`, done is `- [x]` | Toolbar button |

Press Return inside a list and Jotaid continues it with the same type. Press Return again on an empty item to leave the list.

## Nesting

Indentation sets the level: **Tab** indents the current line, **⇧Tab** takes it back out.

```markdown
- First level
  - Second level
    - Third level
- Back to the first level
```

The three types nest inside each other freely — a run of task items under a numbered step is perfectly valid:

```markdown
1. Preparation
   - [ ] Gather sources
   - [ ] Draft an outline
2. Writing
```

Numbered lists render **the numbers you wrote**. If you would rather they renumber themselves, write every line as `1.` — most Markdown tools will count for you.

## Task Lists

A space between the brackets means open; an `x` means done:

```markdown
- [ ] Not done
- [x] Done
- [X] Uppercase counts as done too
```

Either case works — that is what GFM specifies, and it matches GitHub, Obsidian and Typora. In the preview they render as **clickable checkboxes**: tick or untick one directly, without going back to the source to change the letter. Task lists work well for closing out a single note — but to track something *across* notes, a [tag](https://docs.jotaid.com/en/guide/tags) such as `to-read` plus a filter serves better, because a tag gathers scattered notes into one list.

## Next Steps

- [Insert Tables](https://docs.jotaid.com/en/guide/insert-tables) — Structured data
- [Insert Annotations](https://docs.jotaid.com/en/guide/insert-annotations) — Footnotes, super/subscript, highlight
