Title: Nagłówki --- Markdown obsługuje dwa systemy wstawiania nagłówków: **Setext** oraz **atx**. Tak jak akapity, są one elementami blokowymi, co znaczy, że do oddzielenia od innych elementów blokowych (listy, akapity, bloki kodu) stosuje się co najmniej jedną pustą linijkę. Notacja Setext -------------- W notacji Setext, nagłówki zostają "optycznie" podkreślone znakami równości `=` (nagłówek pierwszego rzędu) lub pauz `-` (nagłówek drugiego rzędu). ~~~ Nagłówek 1 ========== Nagłówek 2 ---------- ~~~ Ilość znaków `=` lub `-` nie ma znaczenia, może służyć jedynie celom estetycznym. Notacja atx ----------- Druga metoda pozwala wstawić nagłówki wszystkich rzędów, przy użyciu od jednego do sześciu znaków krzyżyka (hashu) `#` przed treścią nagłówka. ~~~ # nagłówek 1 ## nagłówek 2 ##### nagłówek 5 ~~~ Dopuszczalne jest też zamknięcie nagłówka tymi samymi znakami. Służy to jedynie celom estetycznym, a ilość znaków po nagłówku nie musi się zgadzać z ilością przed nagłówkiem. ~~~ # nagłówek 1 # ## nagłówek 2 #### ##### nagłówek 5 # ~~~ > [important] > > W stosunku do oryginalnego parsera Markdowna, w TypeFriendly poczynione zostały zmiany, które obniżają w generowanym wyjściu XHTML poziom nagłówka o jeden. Ma to związek z tym, że tytuł artykułu jest zawsze najważniejszy, i to on zyskuje znacznik `

`. Wpisany w kod nagłówek pierwszego rzędu zostanie zamieniony na nagłowek drugiego rzędu, drugiego na trzeciego itd. Oznacza to, że choć Markdown (i HTML) udostępnia 6 poziomów nagłówków, to w TypeFriendly dostępnych jest ich 5. Przykładowe nagłówki: > # Nagłówek 1 > > ## Nagłówek 2 > > ### Nagłówek 3 > > #### Nagłówek 4 > > ##### Nagłówek 5 Kotwice w nagłówkach {#headers_anchors} ==================== Nagłówki umożliwiają stworzenie kotwic, dzięki który będzie można [odnieść się][docs.syntax.links#links_anchors] z innych części dokumentacji do wybranego fragmentu rozdziału. Znacznik wygląda następująco: `{#kotwica}`. Umieszcza się go po tekście nagłówka w notacji setext lub na końcu linijki w notacji atx. ~~~ Nagłówek {#kotwica} ======== ### Nagłówek ### {#kotwica} ##### Nagłówek {#kotwica} ~~~ > [important] > > Aby identyfikatory nagłówków były unikalne w obrębie dokumentacji, TypeFriendly dodaje do nich prefiks: `h:id_rodziału:`, dlatego odwołanie się bezpośrednio do kotwicy w linku: `[odnośnik](#kotwica)` nie zadziała.