Pola wyboru Markdown

Pola wyboru (zwane również listami zadań) to świetny sposób na tworzenie list do zrobienia, śledzenie postępów i organizowanie zadań w dokumentach Markdown. Są szczególnie użyteczne na GitHub, GitLab i innych platformach, które obsługują interaktywne pola wyboru.

Podstawowa składnia pola wyboru

Składnia pól wyboru używa kwadratowych nawiasów ze spacją lub 'x' wewnątrz:

- [ ] Niezaznaczone pole wyboru
- [x] Zaznaczone pole wyboru
- [ ] Kolejny niezaznaczony element

Wynik:

  • Niezaznaczone pole wyboru
  • Zaznaczone pole wyboru
  • Kolejny niezaznaczony element

Ważne zasady składni

1. Wymagania dotyczące spacji

  • Musi być spacja po myślniku: - [ ] nie -[ ]
  • Spacja wewnątrz nawiasów dla niezaznaczonego: [ ] nie []
  • Małe 'x' dla zaznaczonego: [x] nie [X]

2. Format listy

Pola wyboru muszą być częścią listy (używając -, +, lub *):
- [ ] To działa
* [ ] To również działa
+ [ ] To też działa

[ ] To nie działa (nie w liście)

Zagnieżdżone pola wyboru

Możesz tworzyć zagnieżdżone listy zadań z podzadaniami:

- [ ] Główne zadanie
- [ ] Podzadanie 1
- [x] Podzadanie 2 (ukończone)
- [ ] Podzadanie 3
- [x] Kolejne główne zadanie
- [x] Jego podzadanie

Wynik:

  • Główne zadanie
  • Podzadanie 1
  • Podzadanie 2 (ukończone)
  • Podzadanie 3
  • Kolejne główne zadanie
  • Jego podzadanie

Praktyczne przykłady

Codzienna lista zadań

## Dzisiejsze zadania

- [ ] Sprawdzenie emaili
- [ ] Przegląd propozycji projektu
- [x] Spotkanie zespołu o 10:00
- [ ] Aktualizacja dokumentacji
- [ ] Planowanie jutrzejszej pracy

Planowanie projektu

## Projekt przeprojektowania strony internetowej

- [x] Faza badawcza
- [x] Wywiady z użytkownikami
- [x] Analiza konkurencji
- [x] Zbieranie wymagań
- [ ] Faza projektowa
- [x] Szkielety
- [ ] Projekt wizualny
- [ ] Prototyp

Mieszanie z innymi formatowaniami

Możesz łączyć pola wyboru z innymi formatowaniami Markdown:

- [x] **Ważne zadanie** (ukończone)
- [ ] *Zwykłe zadanie* (w toku)
- [ ] `Przegląd kodu` dla projektu
- [ ] [Link do dokumentacji](https://example.com)
- [ ] ~~Anulowane zadanie~~ (przekreślone)

Wynik:

  • Ważne zadanie (ukończone)
  • Zwykłe zadanie (w toku)
  • Przegląd kodu dla projektu
  • Link do dokumentacji
  • Anulowane zadanie (przekreślone)

Rozwiązywanie problemów

Typowe problemy

  1. Pole wyboru się nie renderuje: Sprawdź spacje i format listy
  2. Nieinteraktywne: Platforma może nie obsługiwać interaktywnych pól wyboru
  3. Niespójny wygląd: Różne platformy stylizują pola wyboru różnie

Poprawna vs niepoprawna składnia

❌ Niepoprawne:

-[ ] Brak spacji po myślniku
- [] Brak spacji w nawiasach
- [X] Wielkie X
[ ] Nie w liście

✅ Poprawne:

- [ ] Spacja po myślniku
- [ ] Spacja w nawiasach
- [x] Małe x

Pola wyboru są idealne do organizowania zadań i śledzenia postępów. Sprawiają, że twoje dokumenty stają się interaktywne i pomagają utrzymać porządek w projektach!

Gotowy na dodanie treści wizualnych? Naucz się o obrazach w Markdown następnie.