# Task List

Create checklists and change each item’s completion state.

import ContentEditor from '@/components/editor/ContentEditor.astro';

## Create a checklist

Use the Task List entry in the `/` insertion menu, or write checkbox syntax in Source. Edit each item’s text directly and click its checkbox to mark it complete or incomplete.

## Edit in Visual

Click checkboxes and edit task text in place, then switch to Source to inspect the checklist markers.

<ContentEditor content="task-list" />

```markdown
- [x] Connect the repository
  - [x] Confirm the repository access
  - [ ] Confirm the content space
- [ ] Review the document
  - [ ] Check the page metadata
- [ ] Publish the changes
```

## Edit the list

Keep one task per item. Nested tasks can be represented by indenting their Markdown beneath a parent item. Switch to Source when checking the nesting or completion markers.

A checkbox records a value in the document; checking it does not run a product action. This is GitHub Flavored Markdown syntax, rather than an MDX component. See the [Visual Editor demo](/docs/editor/visual-editor/) for editing a task list alongside a documentation component.