Szybki przewodnik po Markdown: składnia, formatowanie i struktura
Szybki przewodnik po Markdown: nagłówki, listy, kod, tabele i wiele więcej.
Język Markdown jest używany w Wikipedii oraz Hugo. Ma on wsparcie dla nagłówków, list, modyfikacji stylu czcionki, obrazów, wyciągów kodu i tabel. Tu przechowuję krótkie omówienie formatowania Markdown.
Powyższy obraz został wygenerowany przez Flux - AI tekst do obrazu.
Markdown to lekki język znacznikowania, który możesz wykorzystać do dodawania elementów formatowania do dokumentów tekstowych. Niniejszy przewodnik oferuje kompleksowy przegląd najczęściej używanej składni Markdown, pomagając Ci tworzyć dobrze strukturalizowane i estetyczne dokumenty.
Ten przewodnik jest częścią Narzędzi do Dokumentacji w 2026: Markdown, LaTeX, PDF i Przepływach Druku hub.
Nagłówki w Markdown (H1–H6)
Nagłówki w Markdown tworzy się za pomocą znaku hasz (#). Liczba znaków hasz przed tekstem nagłówka wskazuje poziom nagłówka.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Pogrubienie, kursywa i nacisk
Markdown oferuje kilka sposobów podkreślania tekstu. Możesz używać gwiazdek (*) lub podkreślników (_) do kursywy oraz podwójnych gwiazdek (**) lub podwójnych podkreślników (__) do pogrubienia.
Kursywa
*Pochylony* lub _pochylony_
Pogrubienie
**Pogrubiony** lub __pogrubiony__
Pogrubienie i kursywa
***Pogrubiony i pochylony*** lub ___pogrubiony i pochylony___
Listy uporządkowane i nieuporządkowane
Markdown obsługuje zarówno listy uporządkowane, jak i nieuporządkowane.
Lista nieuporządkowana
- Element 1
- Element 2
- Podpunkt 1
- Podpunkt 2
Lista uporządkowana
1. Pierwszy element
2. Drugi element
1. Podpunkt 1
2. Podpunkt 2
Hiperłącza w Markdown
Możesz tworzyć linki, otaczając tekst linku nawiasami kwadratowymi ([]) i następnie otaczając adres URL nawiasami okrągłymi (().
[Tekst linku](URL)
Przykład
Zapoznaj się z [Przewodnikiem Markdown](https://www.markdownguide.org/) dla więcej informacji.
Wstawianie obrazów
Obrazy dodaje się za pomocą znaku wykrzyknika (!), po którym następuje tekst alternatywny w nawiasach kwadratowych i adres URL obrazu w nawiasach okrągłych.
Przykład
Cytaty i zagnieżdżone cytaty
Cytaty tworzy się za pomocą znaku większości (>).
> To jest cytata.
Zagnieżdżone cytaty
> To jest pierwszy poziom cytowania.
>> To jest zagnieżdżona cytata.
Kod w linii i bloki kodu
Możesz dodać kod w linii, otaczając go znakami backtick (` ). Dla bloków kodu użyj trzech znaków backtick (``` ) przed i po kodzie.
Kod w linii
Użyj `printf()` do drukowania tekstu w C.
Blok kodu
```python
def hello_world(): print("Hello, World!")
```
Dowiedz się więcej na temat bloków kodu w Markdown – zobacz osobny wpis: Użycie bloków kodu w Markdown.
Reguły poziome (podziały)
Reguły poziome tworzy się za pomocą trzech lub więcej myślników (—), gwiazdek (* **), lub podkreślników (_ __).
---
Tabele
Tabele w Markdown tworzy się za pomocą znaków | i myślników (-).
Przykład
| Nagłówek 1 | Nagłówek 2 |
|-- --------|-- --------|
| Komórka 1 | Komórka 2 |
| Komórka 3 | Komórka 4 |
Aby uzyskać opcje wyrównania, formatowanie wielokolumnowe oraz funkcje specyficzne dla GFM, zobacz Tabele w Markdown: Kompletny Przewodnik.
Listy zadań (zaznaczniki)
Listy zadań to specjalny typ listy, który umożliwia tworzenie zaznaczników.
Przykład
- [x] Zakończone zadanie
- [ ] Nieukończone zadanie
Tekst z przekreśleniem
Tekst z przekreśleniem tworzy się za pomocą podwójnych tyld (~~).
~~To jest tekst z przekreśleniem.~~
Wyróżnianie tekstu
Wyróżnianie tekstu nie jest natively wspierane w Markdown, ale niektóre renderery wspierają to za pomocą składni ==.
Przykład
==To jest wyróżniony tekst.==
Indeksy dolne i gorne
Indeksy dolne tworzy się za pomocą znaku karetki (^) przed tekstem, a indeksy górne tworzy się za pomocą znaku tyldy (~) przed tekstem.
Przykład
H~2~O to woda.
E = mc^2
Równania matematyczne (składnia LaTeX)
Równania matematyczne można dodać za pomocą składni LaTeX w znakach dolara ($).
Przykład
$$ E = mc^2 $$
Ucieczka przed znakami specjalnymi
Aby uciec przed znakami specjalnymi, użyj znaku ukośnika ().
Przykład
\*Pochylony\* lub \_pochylony\_
Ten kompleksowy przewodnik pokrывает istotne składnie Markdown, której potrzebujesz do tworzenia dobrze sformatowanych dokumentów. Aby uzyskać zaawansowane funkcje i dostosowania, odnies się do dokumentacji konkretnych renderów lub dodatkowych zasobów. Jeśli korzystasz z Hugo, Przewodnik po poleceniach Hugo to przydatny przewodnik.
