Markdown — nagłówki, akapity i formatowanie tekstu

To pierwszy z serii artykułów o podstawowej składni Markdown, opartej na oryginalnej specyfikacji Johna Grubera. Niezależnie od tego, czy piszesz dokumentację, README, czy notatki — opanowanie tych fundamentów pozwoli Ci tworzyć czytelne i estetyczne dokumenty.

Nagłówki

Nagłówki tworzysz, stawiając znak # przed tekstem. Liczba znaków # odpowiada poziomowi nagłówka — od 1 do 6.

# Nagłówek poziomu 1
## Nagłówek poziomu 2
### Nagłówek poziomu 3
#### Nagłówek poziomu 4
##### Nagłówek poziomu 5
###### Nagłówek poziomu 6

Alternatywna składnia

Dla nagłówków poziomu 1 i 2 możesz użyć alternatywnej składni z podkreśleniem:

Nagłówek poziomu 1
==================

Nagłówek poziomu 2
------------------

Dobre praktyki

• Zawsze zostawiaj spację po znaku # — # Nagłówek, nie #Nagłówek.
• Dodawaj puste wiersze przed i po nagłówku dla lepszej czytelności i kompatybilności między parserami.

✅ Tak:

Akapit przed nagłówkiem.

# Nagłówek

Akapit po nagłówku.

❌ Nie:

Akapit przed nagłówkiem.
# Nagłówek
Akapit po nagłówku.

Akapity

Akapity w Markdown tworzysz po prostu przez oddzielenie bloków tekstu pustym wierszem.

To jest pierwszy akapit. Wszystkie zdania
w tym samym bloku będą częścią jednego akapitu.

To jest drugi akapit — oddzielony pustą linią.

Ważne: nie wcinaj akapitów spacjami ani tabulatorami (chyba że są wewnątrz listy). Wcięcia mogą zostać zinterpretowane jako bloki kodu.

✅ Tak:
To jest akapit. Wszystko wyrównane do lewej.

❌ Nie:
    To jest akapit z wcięciem — może się źle wyrenderować.

Łamanie wierszy (line break)

Aby złamać wiersz bez tworzenia nowego akapitu (odpowiednik <br> w HTML), zakończ linię dwoma lub więcej spacjami, a następnie naciśnij Enter.

Pierwsza linia.  
Druga linia — zaraz po dwóch spacjach.

Alternatywnie, jeśli Twój parser Markdown obsługuje HTML, możesz użyć znacznika <br>:

Pierwsza linia.<br>
Druga linia.

Dobre praktyki

• Końcowe spacje są trudne do zauważenia w edytorze — wiele osób preferuje <br> dla czytelności.
• Niektóre parsery (CommonMark) pozwalają na użycie backslash \ na końcu linii, ale to mniej kompatybilne rozwiązanie.

Formatowanie tekstu

Pogrubienie (bold)

Użyj dwóch gwiazdek lub dwóch podkreślników:

To jest **pogrubiony tekst**.
To jest również __pogrubiony tekst__.

Aby pogrubić tylko środek słowa, użyj dwóch gwiazdek bez spacji:

Po**gru**bienie

✅ Dla kompatybilności używaj gwiazdek do pogrubiania środka słowa — podkreślniki mogą być nieprawidłowo interpretowane.

Kursywa (italic)

Użyj jednej gwiazdki lub jednego podkreślnika:

To jest *kursywa*.
To jest również _kursywa_.

Kursywa w środku słowa:

A*ku*rat

Pogrubienie i kursywa jednocześnie

Użyj trzech gwiazdek lub trzech podkreślników:

To jest ***bardzo ważny*** tekst.
To jest ___bardzo ważny___ tekst.
To jest __*bardzo ważny*__ tekst.
To jest **_bardzo ważny_** tekst.

W środku słowa:

To jest naprawdę***bardzo***ważny tekst.

✅ Używaj gwiazdek — są bezpieczniejsze przy formatowaniu środka słowa.

Przekreślenie

Nie wszystkie parsery Markdown to obsługują, ale wiele (w tym GitHub Flavored Markdown) pozwala na przekreślenie przy użyciu dwóch tyld:

To jest ~~przekreślony~~ tekst.

Podsumowanie

W kolejnym artykule: listy, cytaty i kod. Tymczasem — wypróbuj te techniki w konwerterze MD2PDF!