Markdown Cheatsheet - Najbardziej przydatne struktury i formatowanie
Przypomnienie przydatnych poleceń obsługiwanych przez Markdown
Język Markdown jest używany w Wikipedii i Hugo. Ma on wsparcie dla nagłówków, list, modyfikacji stylu czcionki, obrazów, cytowanych fragmentów kodu i tabel. Tu przechowuję krótki przegląd formatowania w Markdown.
Powyższy obraz został wygenerowany przez Flux - AI tekst do obrazu.
Markdown to lekkie język znaczników, który możesz używać do dodawania elementów formatowania do dokumentów tekstowych. Niniejszy przewodnik oferuje kompleksowy przegląd najczęściej używanej syntaxi Markdown, pomagając Ci tworzyć dobrze strukturalizowane i wizualnie przyjemne dokumenty.
Nagłówki
Nagłówki w Markdown są tworzone za pomocą znaku #. Liczba znaków # przed tekstem nagłówka wskazuje poziom nagłówka.
# H1
## H2
### H3
#### H4
##### H5
###### H6
Akcentowanie
Markdown oferuje kilka sposobów na akcentowanie tekstu. Możesz użyć gwiazdek (*) lub podkreślników (_) do kursyw i podwójnych gwiazdek (**) lub podwójnych podkreślników (__) do pogrubienia.
Kursywa
*Pochylenie* lub _pochylenie_
Pogrubienie
**Pogrubienie** lub __pogrubienie__
Pogrubienie i pochylenie
***Pogrubienie i pochylenie*** lub ___pogrubienie i pochylenie___
Listy
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
Linki
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 po Markdown](https://www.markdownguide.org/) dla więcej informacji.
Obrazy
Obrazy są dodawane 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
Cytaty są tworzone za pomocą znaku większości (>).
> To jest cytata.
Zagnieżdżone cytaty
> To jest pierwszy poziom cytowania.
>> To jest zagnieżdżony cytata.
Kod w linii i bloki kodu
Możesz dodać kod w linii, otaczając go znakami odwrotnych apostrofów (` ). Dla bloków kodu użyj trzech znaków odwrotnych apostrofów (``` ) przed i po kodzie.
Kod w linii
Użyj `printf()` do drukowania tekstu w języku C.
Blok kodu
```python
python def hello_world(): print("Hello, World!")
```
Dowiedz się więcej o blokach kodu w Markdown – zobacz osobny wpis: Użycie bloków kodu w Markdown
Poziomy reguły
Poziomy reguły są tworzone za pomocą trzech lub więcej myślników (—), gwiazdek (***), lub podkreślników (___).
---
Tabele
Tabele w Markdown są tworzone za pomocą pionowych kresek (|) i myślników (-).
Przykład
| Nagłówek 1 | Nagłówek 2 |
|----------|----------|
| Komórka 1 | Komórka 2 |
| Komórka 3 | Komórka 4 |
Listy zadań
Listy zadań to specjalny typ listy, który umożliwia tworzenie poleceń zaznaczania.
Przykład
- [x] Zakończone zadanie
- [ ] Nieukończone zadanie
Przekreślenie
Tekst przekreślony jest tworzony za pomocą podwójnych tyld (~~).
~~To jest przekreślony tekst.~~
Podświetlanie
Podświetlanie tekstu nie jest natively obsługiwane w Markdown, ale niektóre renderery obsługują to za pomocą składni ==.
Przykład
==To jest podświetlony tekst.==
Indeksy i wykładniki
Indeksy są tworzone za pomocą znaku karetki (^) przed tekstem, a wykładniki są tworzone za pomocą znaku tyldy (~) przed tekstem.
Przykład
H~2~O to woda.
E = mc^2
Równania matematyczne
Równania matematyczne można dodać za pomocą składni LaTeX w znakach dolara ($).
Przykład
$$ E = mc^2 $$
Ucieczka znaków
Aby uciec znakom specjalnym, użyj znaku ukośnika ().
Przykład
\*Pochylenie\* lub \_pochylenie\_
Ten kompleksowy przewodnik pokrywa podstawową składnię Markdown, którą potrzebujesz do tworzenia dobrze sformatowanych dokumentów. Dla zaawansowanych funkcji i dostosowań odnies się do dokumentacji konkretnego renderera lub dodatkowych zasobów.
