Ten poradnik pokrywa wszytsko co trzeba wiedzieć o listach w Markdownie.
Istnieją dwie wersje list: nieuporządkowana i uporządkowana. To dziwny sposób na powiedzenie że są listy z punktami i liczbami
Aby stworzyć
nieuporządkowaną listę, należy poprzedzić tekst gwiazdką ( * ). Każdy
obiekt musi dostać swoją nową linię. Na przykład,
lista zakupów w Markdownie może wyglądać tak:
* Mleko * Jajka * Łosoś * Masło
Ta lista kóncowo wyrenderuje się w:
W okienku poniżej, przekrztałć słowa oddzielone przecinkiem w nieuporządkowaną listę.
Spoko! To właśnie tak tworzy się nieuporządkowane listy. Pogadajmy teraz o uporządkowanych.
Obiekty w uporządkowanej liście są poprzedzone liczbami, a nie gwiazdkami. Spójrz na ten przepis:
Aby napisać to w Markdownie, należy zrobić to w ten sposób:
1. Rozbij 3 jajka nad miską 2. Do miski wlej litr mleka 3. Łososia energicznie natrzyj masłem 4. Wrzuć łososia do miski z mlekiem
Proste, nie? Tak raczej wyobrażamy sobie listy, gdy o nich myślimy.
W okienku poniżej, przekrztałć resztę przepisu w uprządkowaną listę
Wspaniała robota!
Możesz zawsze dodać przechylenie, pogrubienie, lub linki w listach. Można było się spodziewać. W okienku poniżej, zmień łacińskie nazwy roślin na kursywę.
Super!
Może zdarzyć, że będzie potrzeba zagnieżdżenia jednej listy w drugiej. Nie ma co się obawiać, ponieważ składnia Markdownu jest taka sama. Jedyne, co musisz zrobić, to pamiętać o wcięciu każdej gwiazdki o jedno miejsce więcej niż poprzedni element.
Na przykład na poniższej liście dodamy do każdej listy podrzędnej „główny” element listy, szczegółowo opisujący osoby:
* Zabarwienie
* Reporter
* Ma puszyste pomarańczowe włosy
* Przyjaciele z najwspanialszym psem na świecie
* Plamiak
* Kapitan morski
* Ma fantastyczną brodę
* Uwielbia whisky
* Pewnie szkot?
Po wyrenderowaniu lista ta zmienia się w następujące grupowanie:
W poniższym polu zamień cechy postaci na podpunkty.
Fantastycznie! Choć możesz kontynuować wcięcia i dodawać podlisty w nieskończoność, zazwyczaj dobrze jest zatrzymać się po trzech poziomach; w przeciwnym razie twój tekst staje się bałaganem.
Jest jeszcze jedno sztuczka z listami i wcięciami, którą zbadamy, a dotyczy ona przypadku akapitów. Załóżmy, że chcesz utworzyć listę wypunktowaną, która wymaga dodatkowego kontekstu (ale nie innego zestawienia). Na przykład może to wyglądać tak:
Rozbij trzy jajka nad miską
Teraz będziesz chciał rozbijać jajka w taki sposób, aby nie robić bałaganu.
Jeśli zrobiłeś bałagan, użyj ręcznika, aby go posprzątać!
Wlej litr mleka do miseczki.
W zasadzie, postępuj zgodnie z powyższymi wskazówkami: nie rób bałaganu, ale jeśli zrobisz, posprzątaj!
Wysmaruj łososia energicznie masłem.
Przez "energicznie" rozumiemy surowy ruch pionowy. Julia Child kiedyś powiedziała:
W górę i w dół i dookoła, tak właśnie idzie masło na łososia.
Upuść łososia do miski z jajkiem i mlekiem.
Oto kilka technik upuszczania łososia:
Aby utworzyć taki rodzaj tekstu, twój akapit musi zaczynać się od nowej linii poniżej punktu wypunktowania i musi być wcięty co najmniej o jeden znak spacji. Na przykład lista powyżej wygląda tak w Markdown:
1. Rozbij trzy jajka nad miską Teraz będziesz chciał rozbijać jajka w taki sposób, aby nie robić bałaganu. Jeśli _zrobisz_ bałagan, użyj ręcznika, aby go posprzątać! 2. Wlej litre mleka do miseczki. W zasadzie, postępuj zgodnie z powyższymi wskazówkami: nie rób bałaganu, ale jeśli zrobisz, posprzątaj! 3. Wysmaruj łososia energicznie masłem. Przez "energicznie" rozumiemy surowy ruch pionowy. Julia Child kiedyś powiedziała: > W górę i w dół i dookoła, tak właśnie idzie masło na łososia. 4. Upuść łososia do miski z jajkiem i mlekiem. Oto kilka technik upuszczania łososia: * Sprawdź, czy nie ma pstrąga ani dzieci * Użyj obu rąk * Zawsze miej ręcznik pod ręką na wypadek bałaganu
Zauważ, że pierwsze dwa elementy mają pojedynczą spację. Wygląda to trochę dziwnie, więc możesz chcieć odpowiednio wcięć, aby dopasować znaki (jak elementy trzy i cztery). W tych akapitach możesz zawierać wszelkiego rodzaju inne elementy Markdown, takie jak cytaty blokowe, czy nawet inne listy!
W poniższym polu zamień punkty wypunktowania na własne akapity.