Caixas de Seleção em Markdown

Caixas de seleção (também chamadas de listas de tarefas) são uma ótima maneira de criar listas de afazeres, acompanhar progresso e organizar tarefas em seus documentos Markdown. São especialmente úteis no GitHub, GitLab e outras plataformas que suportam caixas de seleção interativas.

Sintaxe Básica de Caixa de Seleção

A sintaxe para caixas de seleção usa colchetes com um espaço ou 'x' dentro: 

- [ ] Caixa de seleção não marcada
- [x] Caixa de seleção marcada
- [ ] Outro item não marcado

Resultado:

  • Caixa de seleção não marcada

  • Caixa de seleção marcada
  • Outro item não marcado

Regras Importantes de Sintaxe

1. Requisitos de Espaço

  • •
    Deve ter espaço após o hífen: - [ ] não -[ ]
  • •
    Espaço dentro dos colchetes para não marcado: [ ] não []
  • •
    'x' minúsculo para marcado: [x] não [X]

2. Formato de Lista

Caixas de seleção devem fazer parte de uma lista (usando -, +, ou *): 
- [ ] Isso funciona
* [ ] Isso também funciona
+ [ ] Isso funciona também

[ ] Isso não funciona (não está em uma lista)

Caixas de Seleção Aninhadas

Você pode criar listas de tarefas aninhadas com sub-tarefas: 

- [ ] Tarefa principal
  - [ ] Sub-tarefa 1
  - [x] Sub-tarefa 2 (concluída)
  - [ ] Sub-tarefa 3
- [x] Outra tarefa principal
  - [x] Sua sub-tarefa

Resultado:

  • Tarefa principal

  • Sub-tarefa 1
  • Sub-tarefa 2 (concluída)
  • Sub-tarefa 3
  • Outra tarefa principal
  • Sua sub-tarefa

Exemplos Práticos

Lista de Afazeres Diários

## Tarefas de Hoje

- [ ] Verificar emails
- [ ] Revisar proposta do projeto
- [x] Reunião da equipe às 10h
- [ ] Atualizar documentação
- [ ] Planejar trabalho de amanhã

Planejamento de Projeto

## Projeto de Redesign do Site

- [x] Fase de pesquisa
  - [x] Entrevistas com usuários
  - [x] Análise da concorrência
  - [x] Coleta de requisitos
- [ ] Fase de design
  - [x] Wireframes
  - [ ] Design visual
  - [ ] Protótipo

Misturando com Outras Formatações

Você pode combinar caixas de seleção com outras formatações Markdown: 

- [x] **Tarefa importante** (concluída)
- [ ] *Tarefa regular* (em progresso)
- [ ] `Revisão de código` para projeto
- [ ] [Link para documentação](https://exemplo.com)
- [ ] ~~Tarefa cancelada~~ (riscada)

Resultado:

  • Tarefa importante (concluída)

  • Tarefa regular (em progresso)

  • Revisão de código para projeto

  • Link para documentação
  • Tarefa cancelada (riscada)

Solução de Problemas

Problemas Comuns

  1. Caixa de seleção não renderiza: Verifique espaçamento e formato de lista

  2. Não interativa: A plataforma pode não suportar caixas de seleção interativas
  3. Aparência inconsistente: Diferentes plataformas estilizam caixas de seleção de forma diferente

Sintaxe Correta vs Incorreta

❌ Incorreto: 

-[ ] Sem espaço após hífen
- [] Sem espaço nos colchetes
- [X] X maiúsculo
[ ] Não está em uma lista

✅ Correto: 

- [ ] Espaço após hífen
- [ ] Espaço nos colchetes
- [x] x minúsculo

Caixas de seleção são perfeitas para organizar tarefas e acompanhar progresso. Elas tornam seus documentos interativos e ajudam a manter projetos organizados!

Pronto para adicionar algum conteúdo visual? Aprenda sobre imagens em Markdown a seguir.