Ściągawka Markdown: składnia GitHub-Flavored z przykładami

Markdown to najprostszy sposób na pisanie sformatowanego tekstu, który pozostaje czytelny jako zwykły tekst. Używają go pliki README, dokumentacja, notatki, komunikatory i strony statyczne. Ta ściągawka obejmuje składnię, której naprawdę będziesz używać, ze szczególnym uwzględnieniem GitHub-Flavored Markdown (GFM) — dialektu obsługiwanego przez GitHub, GitLab, większość narzędzi do dokumentacji i Markdown Preview Editor.

Każdy przykład poniżej możesz wkleić do edytora online i zobaczyć wynik obok źródła.

Nagłówki

Zacznij wiersz od jednego do sześciu znaków #, a po nich wstaw spację. Jeden # to tytuł strony, ## sekcja, ### podsekcja.

markdown# Tytuł strony
## Sekcja
### Podsekcja
#### Mniejszy nagłówek

Używaj jednego nagłówka # na dokument i nie przeskakuj poziomów (na przykład z ## od razu do ####). Czytniki ekranu i wyszukiwarki korzystają ze struktury nagłówków, aby zrozumieć stronę, a większość podglądów tworzy na jej podstawie spis treści.

Akapity i łamanie wierszy

Akapit to jeden lub więcej wierszy tekstu oddzielonych pustą linią. Pojedyncze przejście do nowej linii wewnątrz akapitu jest ignorowane — wiersze zostają połączone. Aby wymusić złamanie wiersza, zakończ go dwiema spacjami lub ukośnikiem wstecznym:

markdownPierwszy wiersz z dwiema spacjami na końcu  
Drugi wiersz w tym samym akapicie.

Nowy akapit zaczyna się po pustej linii.

Wyróżnienia

Wiele edytorów, w tym Markdown Preview Editor, obsługuje też kilka popularnych rozszerzeń: ==wyróżnienie==, H~2~O dla indeksu dolnego, x^2^ dla indeksu górnego i skróty emoji w stylu :smile:. Nie są one częścią samego GFM, więc zanim na nich polegasz, sprawdź platformę docelową.

Listy

Używaj -, * lub + dla list punktowanych i liczb dla list numerowanych. Aby zagnieździć elementy, dodaj wcięcie od dwóch do czterech spacji.

markdown- Mleko
- Chleb
  - Pełnoziarnisty
  - Żytni
- Kawa

1. Sklonuj repozytorium
2. Zainstaluj zależności
3. Uruchom budowanie

Listy numerowane nie wymagają poprawnych numerów — 1. w każdym wierszu i tak wyświetli się jako 1, 2, 3. Rozpoczęcie od innej liczby (na przykład 5.) sprawi, że lista zacznie się od niej.

Listy zadań

Listy zadań to rozszerzenie GFM, które zamienia elementy listy w pola wyboru. Idealnie sprawdzają się w plikach README, planach wydań i notatkach ze spotkań.

markdown- [x] Napisać szkic
- [x] Dodać zrzuty ekranu
- [ ] Opublikować wpis

Linki

markdown[Tekst linku](https://example.com)
[Link z tytułem](https://example.com "Widoczny po najechaniu")
<https://example.com>

Przeczytaj [instrukcję instalacji][install].

[install]: https://example.com/docs/install

Ostatnia forma to link referencyjny: adres URL definiuje się raz na końcu dokumentu, dzięki czemu długie akapity pozostają czytelne. Linki względne, takie jak [Setup](docs/setup.md), wskazują inne pliki w tym samym projekcie; w Markdown Preview Editor przełączają na dany dokument, jeśli jest otwarty w innej karcie.

Obrazy

Obrazy używają składni linków z wykrzyknikiem na początku. Tekst w nawiasach kwadratowych to tekst alternatywny — opisz obraz dla osób, które go nie widzą.

markdown![Edytor z podglądem na żywo](images/screenshot.png)
![Logo](https://example.com/logo.svg "Opcjonalny tytuł")

Gdy wyświetlasz podgląd dokumentu odwołującego się do lokalnych obrazów, otwórz cały folder lub upuść obrazy razem z plikiem .md, aby podgląd mógł odnaleźć ścieżki względne.

Kod

Kod w tekście otacza się pojedynczymi grawisami (backtickami). W przypadku bloków umieść kod między potrójnymi grawisami i dodaj nazwę języka, aby włączyć podświetlanie składni:

markdown```js
function greet(name) {
  return `Hello, ${name}!`;
}
```

Popularne nazwy języków: js, ts, python, bash, json, yaml, html, css, sql, go, rust, diff. Jeśli sam kod zawiera potrójne grawisy, otocz go czterema, jak w przykładzie powyżej.

Tabele

Oddzielaj kolumny pionowymi kreskami, a pod nagłówkiem umieść wiersz myślników. Dwukropki w wierszu separatora ustawiają wyrównanie.

markdown| Funkcja   | Darmowa | Uwagi                      |
|:----------|:-------:|---------------------------:|
| Podgląd   |   ✅    | Aktualizuje się na bieżąco |
| Eksport   |   ✅    | HTML, PDF, .md             |

:--- wyrównuje do lewej, :---: do środka, a ---: do prawej. Kolumny w źródle nie muszą być wyrównane — ale dobry edytor dba o ich czytelność. Markdown Preview Editor ma na pasku narzędzi przycisk tabeli, który wstawia gotowy szablon.

Cytaty i ramki

Poprzedź wiersze znakiem >, aby zacytować tekst. GitHub obsługuje też ramki (alerty) — cytaty ze specjalnym pierwszym wierszem, wyświetlane jako kolorowe wyróżnione bloki:

markdown> Zwykły cytat.

> [!NOTE]
> Przydatna informacja, którą użytkownicy powinni znać.

> [!TIP]
> Pomocna rada, jak zrobić coś lepiej.

> [!WARNING]
> Pilna informacja, która wymaga natychmiastowej uwagi.

Pięć typów ramek to NOTE, TIP, IMPORTANT, WARNING i CAUTION. Używaj ich oszczędnie: jedna ramka na sekcję przyciąga uwagę, pięć pod rząd to już szum.

Przypisy

Przypisy pozwalają usunąć uwagi poboczne z głównego tekstu. Przypis można zdefiniować w dowolnym miejscu; wyświetla się na końcu dokumentu.

markdownMarkdown powstał w 2004 roku.[^1]

[^1]: Autorem jest John Gruber, przy pomocy Aarona Swartza.

Linie poziome i znaki ucieczki

Trzy lub więcej myślników, gwiazdek lub podkreślników w osobnym wierszu tworzą linię poziomą: ---. Wstaw przed nią pustą linię, w przeciwnym razie --- pod wierszem tekstu zamieni ten tekst w nagłówek.

Aby wyświetlić znak, który Markdown zinterpretowałby inaczej, poprzedź go ukośnikiem wstecznym: \*to nie kursywa\*, \# to nie nagłówek, \$5 (przydatne, gdy włączone są wzory).

Wzory i diagramy

Dwa rozszerzenia stały się standardem w pisaniu technicznym:

• Wzory — $E = mc^2$ dla wzorów w tekście i $$ … $$ dla wzorów w osobnym wierszu. Zobacz pełny poradnik o wzorach matematycznych w Markdown.
• Diagramy — blok kodu z językiem mermaid rysuje schematy blokowe, diagramy sekwencji, wykresy Gantta i nie tylko. Zobacz diagramy Mermaid w Markdown.

Metadane (front matter)

Generatory stron statycznych odczytują metadane z bloku YAML na samym początku pliku:

yaml---
title: Mój wpis
date: 2026-09-27
tags: [markdown, docs]
---

Dobry podgląd ukrywa ten blok, zamiast wyświetlać go jako tekst. Markdown Preview Editor robi dokładnie to.

Co dalej

Znajomość składni to połowa sukcesu — druga połowa to widzenie efektu podczas pisania. Przeczytaj, jak wyświetlić podgląd Markdown online bez wysyłania plików, a gdy dokument będzie gotowy, dowiedz się, jak przekonwertować Markdown do HTML lub PDF.