- 3.4. Składnia pliku
3.4.8. Listy porządkowe - 3.4.7. Grafika i obrazki
« Poprzedni - 3.4.9. Bloki kodu
Następny »
3.4.8. Listy porządkowe
Markdown wspiera listy wypunktowane oraz numeryczne. Listy są elementami blokowymi, należy je więc poprzedzać i kończyć co najmniej jedną pustą linijką.
Dodanie listy numerowanej jest niezwykle proste:
Tekst
1. Element 1
2. Element 2
3. Element 3
Tekst
Tekst
- Element 1
- Element 2
- Element 3
Tekst
Wpisane numery nie mają znaczenia - mogą być w innej kolejności, mogą się powtarzać, tworzą jedynie walor estetyczny podczas przeglądania kodu dokumentu. Poniższa lista da taki sam efekt jak podana wyżej:
3. Element 1
3. Element 2
68. Element 3
Do tworzenia listy wypunktowanej, linijka musi zaczynać się od znaku gwiazdki *, plusa + lub minusa (pauzy) -:
+ Element 1
+ Element 2
+ Element 3
tekst
* Element 1
* Element 2
* Element 3
tekst
- Element 1
- Element 2
- Element 3
- Element 1
- Element 2
- Element 3
To, którego znaku użyjemy, nie ma znaczenia - może to być którykolwiek z nich.
Znaczniki list mogą być oddzielone od tekstu jedną, bądź więcej spacją lub tabulacją. Znaczniki list powinny zaczynać się na początku linijek, można jednak odsunąć je od brzegu maksymalnie trzema spacjami.
Linijki w elementach listy można przełamywać, które możesz odsunąć dla estetyki na tę samą odległość co pierwsza linijka:
* Litwo! Ojczyzno moja! ty jesteś jak zdrowie.
Ile cię trzeba cenić, ten tylko się dowie,
Kto cię stracił. Dziś piękność twą w całej ozdobie
Widzę i opisuję, bo tęsknię po tobie.
* Panno Święta, co jasnej bronisz Częstochowy
I w Ostrej świecisz Bramie! Ty, co gród zamkowy...
Jeśli jesteś jednak leniwy, nie musisz tego robić:
* Litwo! Ojczyzno moja! ty jesteś jak zdrowie.
Ile cię trzeba cenić, ten tylko się dowie,
Kto cię stracił. Dziś piękność twą w całej ozdobie
Widzę i opisuję, bo tęsknię po tobie.
* Panno Święta, co jasnej bronisz Częstochowy
I w Ostrej świecisz Bramie! Ty, co gród zamkowy...
- Litwo! Ojczyzno moja! ty jesteś jak zdrowie. Ile cię trzeba cenić, ten tylko się dowie, Kto cię stracił. Dziś piękność twą w całej ozdobie Widzę i opisuję, bo tęsknię po tobie.
- Panno Święta, co jasnej bronisz Częstochowy I w Ostrej świecisz Bramie! Ty, co gród zamkowy...
Jeśli elementy listy oddzielone są jedną pustą linijką, Markdown ich treść zawrze w znacznikach akapitu <p>.
Gdy wpiszesz:
* Element 1
* Element 2
* Element 3
Otrzymasz:
- Element 1
- Element 2
- Element 3
Ale oddzielenie elementów pustymi linijkami:
* Element 1
* Element 2
* Element 3
Da efekt w postaci:
Element 1
Element 2
Element 3
Możesz w elementach listy zarzeć kolejne akapity. Muszą być one otoczone pustymi linijkami oraz zaczynać się czterema spacjami bądź tabulacją.
* Litwo! Ojczyzno moja! ty jesteś jak zdrowie.
Ile cię trzeba cenić, ten tylko się dowie,
Kto cię stracił. Dziś piękność twą w całej ozdobie
Widzę i opisuję, bo tęsknię po tobie.
* Panno Święta, co jasnej bronisz Częstochowy
I w Ostrej świecisz Bramie! Ty, co gród zamkowy...
Litwo! Ojczyzno moja! ty jesteś jak zdrowie. Ile cię trzeba cenić, ten tylko się dowie,
Kto cię stracił. Dziś piękność twą w całej ozdobie Widzę i opisuję, bo tęsknię po tobie.
Panno Święta, co jasnej bronisz Częstochowy I w Ostrej świecisz Bramie! Ty, co gród zamkowy...
System wstawiania akapitów niesie ze sobą pewne konsekwencje. Niemożliwe jest umieszczenie bezpośrednio pod sobą osobnych list, gdyż zamienione zostają one w jedną:
1. Element 1 2. Element 2 3. Element 3 1. Element 1 2. Element 2 3. Element 3
- Element 1
- Element 2
- Element 3
- Element 1
- Element 2
- Element 3
Sprawa ta nadal dyskutowana jest podczas opracowywania specyfikacji języka Markdown. Jedynym zalecanym rozwiązaniem jest skorzystanie z HTML-owego komentarza
<!-- # -->i wstawienie go między listami, co spowoduje ich rodzielenie.
Zagnieżdżone listy
Kolejne poziomy zagnieżdżonych list należy poprzedzać spacjami bądź tabulacjami.
Wpisanie:
1. Element 1
- Element 1.1
- Element 1.2
1. Element 1.2.1
- Element 1.3
2. Element 2
* Element 2.1
* Element 2.2
3. Element 3
Da nam:
- Element 1
- Element 1.1
- Element 1.2
- Element 1.2.1
- Element 1.3
- Element 2
- Element 2.1
- Element 2.2
- Element 3
Zobacz także:
3.4.8. Listy porządkowe
3.4. Składnia pliku- « Poprzedni
3.4.7. Grafika i obrazki - Następny »
3.4.9. Bloki kodu