---
title: "Turn a list into next steps."
description: "Write ordinary lists, ordered steps and checkable tasks."
canonical: https://editmd.app/learn/lessons/tasks/
markdown: https://editmd.app/learn/lessons/tasks.md
status: pre-release, waiting list open
generated: editmd-website
---

# Turn a list into next steps.

Lesson 04 of 12 in Markdown School. Write ordinary lists, ordered steps and checkable tasks.

## Use a list when items belong together

Start each item with a hyphen and a space. An ordinary list can hold supplies, questions or ideas. Use a numbered list when the order is part of the meaning. [CommonMark lists](https://spec.commonmark.org/0.31.2/#lists).

```markdown
- A measuring tape
- A notebook
- Two layout sketches
```

```markdown
1. Measure the space.
2. Compare the sketches.
3. Choose a layout.
```

## Add a completion state

A task list adds `[ ]` for an open task or `[x]` for a completed task after the list marker. Include a space before the task text. Task lists are a GFM extension, so support depends on the renderer. [GFM task list items](https://github.github.com/gfm/#task-list-items-extension-).

```markdown
- [x] Sketch the layout
- [ ] Bring a measuring tape
```

The practice preview shows the state as a symbol. Change the source to update it. In editmd’s Mac preview, supported task checkboxes can update the corresponding source marker; the [writing guide](/docs/writing/#tables-and-tasks) explains that behaviour.

## Write tasks someone can act on

“Bench” names a subject. “Measure the bench before choosing a layout” describes an action. Add an owner or date when the facts are known. If they are unknown, leave a question rather than inventing an assignment.

## Try an open task and a finished one

Mark one supplied task complete and add another action. The check confirms that the source contains both states. It cannot know whether the work actually happened.

## Exercise

Keep at least one open task and one completed task. Add a useful action of your own and decide whether it is done.

## Takeaway

Lists group information. Tasks also record whether work is complete.

Related guide: https://editmd.app/docs/writing/. All lessons: https://editmd.app/learn.md