Przydatne wskazówki dotyczące Markdownu: Składnia, formatowanie i struktura – szybkie odniesienie
Szybki przewodnik po Markdown: nagłówki, listy, kod, tabele i wiele więcej.
Język Markdown jest używany w Wikipedii oraz Hugo. Obsługuje nagłówki, listy, modyfikacje stylów czcionek, obrazy, cytaty kodu oraz tabele. Poniżej znajduje się krótkie podsumowanie formatowania w Markdown.
Powyższy obrazek został wygenerowany przez Flux - AI tekst do obrazu.
Markdown to lekki język znaczników, który możesz wykorzystać do dodawania elementów formatowania do dokumentów tekstowych. Ten przewodnik oferuje kompleksowy przegląd najczęściej używanej składni Markdown, pomagając Ci tworzyć dobrze ustrukturyzowane i wizualnie atrakcyjne dokumenty.
Ten skrót informacji jest częścią hubu Narzędzia do dokumentacji w 2026 roku: Markdown, LaTeX, PDF & Workflow wydruków.
Nagłówki w Markdown (H1–H6)
Nagłówki w Markdown tworzone są przy użyciu znaku wykrzyknika (#). Liczba znaków wykrzyknika przed tekstem nagłówka określa poziom nagłówka.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Pogrubienie, Kursywa i Wyróżnienie
Markdown oferuje kilka sposobów na wyróżnienie tekstu. Możesz użyć gwiazdek (*) lub podkreśleń (_) dla kursywy oraz podwójnych gwiazdek (**) lub podwójnych podkreśleń (__) dla pogrubienia.
Kursywa
*Kursywa* lub _kursywa_
Pogrubienie
**Pogrubienie** lub __pogrubienie__
Pogrubienie i Kursywa
***Pogrubienie i kursywa*** lub ___pogrubienie i kursywa___
Listy numerowane i nienumerowane
Markdown obsługuje zarówno listy numerowane, jak i nienumerowane.
Lista nienumerowana
- Element 1
- Element 2
- Podpunkt 1
- Podpunkt 2
Lista numerowana
1. Pierwszy element
2. Drugi element
1. Podpunkt 1
2. Podpunkt 2
Linki w Markdown
Możesz tworzyć linki, umieszczając tekst linku w nawiasach kwadratowych ([]) a następnie URL w nawiasach okrągłych (()).
[Tekst Linku](URL)
Przykład
Odwiedź [Przewodnik po Markdown](https://www.markdownguide.org/) po więcej informacji.
Wstawianie Obrazów
Obrazy dodaje się przy użyciu znaku wykrzyknika (!) po którym następuje tekst alternatywny w nawiasach kwadratowych oraz URL obrazu w nawiasach okrągłych.
Przykład
Cytaty Blokowe i Zagnieżdżone Cytaty
Cytaty blokowe tworzone są przy użyciu znaku większości (>).
> To jest cytat blokowy.
Zagnieżdżone Cytaty Blokowe
> To jest pierwszy poziom cytowania.
>> To jest zagnieżdżony cytat blokowy.
Kod Inline i Bloki Kodu
Możesz dodać kod inline, otaczając go apostrofami kodu (` ). Dla bloków kodu użyj potrójnych apostrofów kodu (``` ) przed i po kodzie.
Kod Inline
Użyj `printf()` do drukowania tekstu w C.
Bloki Kodu
```python
python def hello_world(): print("Hello, World!")
```
Wicej na temat bloków kodu w Markdown - zobacz osobny post: Używanie Bloków Kodu w Markdown. Identyfikator języka mermaid jest jednym z godnych uwagi przypadków specjalnych — uruchamia renderowanie diagramów zamiast kolorowania składni, przekształcając zwykły zablokowany blok w diagram przepływu lub diagram sekwencji. Szybki Start z Diagramami Mermaid omawia pełną składnię diagramów od diagramów przepływu po diagramy ER.
Linie Poziome (Separatory)
Linie poziome tworzone są przy użyciu trzech lub więcej myślników (—), gwiazdek (***) lub podkreśleń (___).
---
Tabele
Tabele w Markdown tworzone są przy użyciu znaków pipe (|) i myślników (-).
Przykład
| Nagłówek 1 | Nagłówek 2 |
|----------|----------|
| Komórka 1 | Komórka 2 |
| Komórka 3 | Komórka 4 |
Opcje wyrównania, formatowanie wielokolumnowe i funkcje specyficzne dla GFM znajdziesz w Tabele w Markdown: Kompletny Przewodnik.
Listy Zadań (Pola Opcjonalne)
Listy zadań to specjalny rodzaj listy, który pozwala tworzyć pola opcjonalne.
Przykład
- [x] Ukończone zadanie
- [ ] Niedokończone zadanie
Przekreślenie Tekstu
Przekreślenie tekstu tworzone jest przy użyciu podwójnych tyld (~~).
~~To jest przekreślony tekst.~~
Podświetlanie Tekstu
Podświetlanie tekstu nie jest natywnie wspierane w Markdown, ale niektóre renderery obsługują je przy użyciu składni ==.
Przykład
==To jest podświetlony tekst.==
Indeksy Dolne i Górne
Indeksy dolne tworzone są przy użyciu znaku ^ przed tekstem, a indeksy górne przy użyciu znaku ~ przed tekstem.
Przykład
H~2~O to woda.
E = mc^2
Równania Matematyczne (Składnia LaTeX)
Równania matematyczne można dodawać przy użyciu składni LaTeX wewnątrz znaków dolara ($).
Przykład
$$ E = mc^2 $$
Escapowanie Specjalnych Znaków
Aby escape’ować specjalne znaki, użyj backslash ().
Przykład
\*Kursywa\* lub \_kursywa\_
Ten kompleksowy skrót informacji obejmuje podstawową składnię Markdown, której potrzebujesz do tworzenia dobrze sformatowanych dokumentów. W przypadku bardziej zaawansowanych funkcji i dostosowań, odwołaj się do dokumentacji konkretnego renderera lub dodatkowych zasobów. Jeśli używasz Hugo, Skrót Informacji o Komendach Hugo jest przydatnym dodatkiem.
Markdown jest również domyślnym formatem przechowywania dla samodzielnie hostowanych wiki i systemów wiedzy. DokuWiki wykorzystuje przyjazne dla Markdown podejście do czystego tekstu dla baz wiedzy osobistych i zespołowych. Dla systemów wiedzy wspomaganych przez AI opartych na stronach Markdown, LLM Wiki wyjaśnia, dlaczego portowalność i zdolność do różnicowania tego formatu sprawiają, że jest on właściwą podstawą dla skompilowanej wiedzy.
