Markdown: co to jest i jak w nim pisać notatki (poradnik i ściągawka)

Markdown to prosty sposób formatowania zwykłego tekstu za pomocą kilku znaków z klawiatury: # na początku wiersza tworzy nagłówek, **dwie gwiazdki** pogrubiają tekst, a - zaczyna punkt listy. Piszesz znaki, aplikacja obsługująca Markdown pokazuje sformatowany wynik, a sam plik pozostaje czytelnym tekstem, który otworzysz na każdym urządzeniu.

Dlatego Markdown świetnie nadaje się do codziennych notatek. Ten poradnik jest dla początkujących. Wyjaśnia, co to jest Markdown, pokazuje każdy podstawowy element obok jego efektu, a na koniec daje Ci ściągawkę do zapisania w zakładkach, listę typowych błędów i nawyki, dzięki którym pisze się szybciej.

Markdown: co to jest?

Markdown to lekki język znaczników. „Znaczniki” to po prostu oznaczenia, które dodajesz do tekstu, żeby powiedzieć, jak ma wyglądać: to jest nagłówek, to słowo jest ważne, te wiersze tworzą listę. HTML, język stron internetowych, też jest językiem znaczników, ale bardzo rozwlekłym: <strong>mleko</strong>. Markdown robi to samo zapisem **mleko**.

Markdown stworzył John Gruber w 2004 roku, a dużą część uwag do składni wniósł Aaron Swartz. Na oryginalnej stronie projektu Gruber pisze, że najważniejszym celem było, by tekst był „tak czytelny, jak to tylko możliwe” (tłum. własne). Dokument w Markdown ma mieć sens nawet wtedy, gdy nikt go nigdy nie przekształci. Listę zakupów zapisaną w Markdown przeczytasz bez problemu w surowej postaci.

Jeden język, kilka dialektów

Pierwotny opis Grubera pozostawiał część szczegółów otwartych, więc różne programy zaczęły ten sam tekst interpretować nieco inaczej. Żeby to uporządkować, grupa programistów napisała CommonMark, czyli precyzyjną specyfikację podstawowej składni. Aktualna wersja (stan na wrzesień 2026 roku) to 0.31.2 ze stycznia 2024 roku.

GitHub zbudował na niej GitHub Flavored Markdown (GFM). Ten wariant dodaje tabele, listy zadań z polami wyboru, przekreślenie i automatyczne linki. Większość aplikacji do notatek obsługuje CommonMark i całość lub część GFM, a do tego własne dodatki, na przykład zakreślacz albo linki między notatkami.

Dialekt Markdown

Odmiana Markdown z własnymi dodatkami albo drobnymi różnicami. Podstawy z tego poradnika działają tak samo niemal w każdym dialekcie. Różnią się dopiero rozszerzenia.

Dla Twoich notatek oznacza to jedno: podstawy opisane niżej są bezpieczne wszędzie. Gdy sięgasz po rozszerzenie, sprawdź, czy rozumieją je inne aplikacje, z których korzystasz. W artykule o tabelach, listach zadań, wzorach i diagramach przy każdej funkcji zaznaczamy, z jakiego dialektu pochodzi.

Dlaczego warto pisać notatki w Markdown?

Wiele aplikacji do notatek używa własnego, wewnętrznego formatu. Klikasz przycisk pogrubienia, a program zapisuje to formatowanie w sposób, który w pełni rozumie tylko on. Markdown działa odwrotnie: formatowanie jest częścią samego tekstu. Ma to praktyczne skutki.

Plik MD: co to jest?

Plik .md to zwykły plik tekstowy z inną końcówką nazwy. Od 2016 roku ma nawet własny, oficjalnie zarejestrowany typ text/markdown (RFC 7763). Otworzysz go wbudowanym edytorem każdego systemu: Notatnikiem w Windows, TextEdit na Macu albo dowolnym edytorem kodu.

Zwykły tekst to jeden z najstarszych i najszerzej obsługiwanych formatów cyfrowych. Dlatego o Markdown mówi się, że jest odporny na upływ czasu. Nikt nie obieca tego żadnemu plikowi na zawsze, ale format czytelny dla człowieka bez żadnego programu jest najbliżej tego ideału. Gdyby Twoja aplikacja do notatek zniknęła jutro, folder plików .md nadal byłby folderem czytelnych notatek. Na tym samym pomyśle opiera się podejście local-first: notatki mają działać na Twoim urządzeniu, także offline, niezależnie od tego, co stanie się z serwerem.

Jak pisać w Markdown: podstawy

Każdy przykład poniżej pokazuje po lewej (na telefonie: u góry), co piszesz, a po prawej, co wyświetli aplikacja. Najlepiej od razu wypróbuj je w dowolnym edytorze Markdown.

Nagłówki

Zacznij wiersz od jednego do sześciu znaków # i spacji. Jeden # to największy nagłówek, zwykle tytuł notatki. Dwa oznaczają sekcję, trzy podsekcję i tak dalej.

# Wyjazd na Hel
## Co spakować
### Dokumenty

Spacja po # ma znaczenie. W CommonMark #Dokumenty to zwykły tekst, a nie nagłówek. W praktyce większości notatek wystarczają dwa albo trzy poziomy.

Akapity i łamanie wierszy

To reguła, która zaskakuje większość początkujących. Pusty wiersz zaczyna nowy akapit. Pojedynczy Enter zwykle nie. Wiele programów wyświetlających Markdown łączy kolejne wiersze w jeden akapit.

Zadzwonić do dentysty
Kupić bilet na pociąg

Zapytać Anię o sobotę

Dwa pierwsze wiersze stały się jednym akapitem ze spacją w środku. Jeśli naprawdę chcesz przejść do nowego wiersza w obrębie akapitu, na przykład w adresie, zakończ wiersz ukośnikiem wstecznym \. Działa też stary sposób, czyli dwie spacje na końcu wiersza, ale spacji nie widać i łatwo je zgubić.

Anna Nowak\
ul. Długa 12\
80-827 Gdańsk

Pogrubienie, kursywa i przekreślenie

Otocz tekst jedną gwiazdką, żeby uzyskać kursywę, dwiema dla pogrubienia, trzema dla obu naraz. Działają też podkreślniki (_kursywa_, __pogrubienie__), ale gwiazdki są bezpieczniejszym nawykiem, bo działają również w środku wyrazu. Przekreślenie to dwie tyldy. Pochodzi z GFM, więc działa w większości aplikacji, choć nie należy do CommonMark.

Lot jest *chyba* w **piątek**.
Wylot o ***6:40 rano***.
~~Wziąć taksówkę~~ Pojechać SKM-ką.

Listy

Listę punktowaną tworzysz, zaczynając każdy wiersz od -, * albo + i spacji. Wybierz jeden znak i trzymaj się go; najpopularniejszy jest -. Lista numerowana to liczba, kropka i spacja.

- Dowód osobisty
- Ładowarka
- Krem z filtrem

1. Odprawa online
2. Wydruk karty pokładowej
3. Wyjście z domu o 5:30

Wpisane numery mają mniejsze znaczenie, niż się wydaje. W CommonMark liczy się tylko pierwszy: lista zapisana jako 1., 1., 1. i tak wyświetli się jako 1, 2, 3. Dzięki temu łatwo potem zmieniać kolejność kroków.

Żeby umieścić listę w liście, wcinaj punkty wewnętrzne tak, by zaczynały się pod tekstem punktu powyżej. Cztery spacje działają zarówno dla list punktowanych, jak i numerowanych, a większość edytorów pozwala po prostu nacisnąć Tab.

- Ubrania
    - Lekka kurtka
    - Wygodne buty
- Kosmetyki
    - Szczoteczka do zębów

Linki

Tekst, który ma być klikalny, wpisz w nawiasy kwadratowe, a adres zaraz za nimi w nawiasy okrągłe, bez spacji pomiędzy. Jeśli chcesz pokazać sam adres jako link, otocz go nawiasami ostrymi.

Bilety są na [stronie muzeum](https://www.example.com/bilety).
Godziny otwarcia: <https://www.example.com/godziny>

Wiele aplikacji samo zamienia goły adres https:// w link. To funkcja GFM, więc nawiasy ostre są wyborem bardziej uniwersalnym. Aplikacje do notatek często dodają też własne linki między notatkami, na przykład [[Tytuł notatki]]. To rozszerzenie, które opisujemy w poradniku dla zaawansowanych.

Obrazy

Obraz zapisuje się jak link poprzedzony wykrzyknikiem. Tekst w nawiasach kwadratowych to tekst alternatywny: krótki opis, który czytnik ekranu odczyta na głos i który pojawi się, gdy obrazek się nie wczyta.

Piszesz

![Kapibara siedząca nad stawem](/illustrations/empty-notes.png)

Widzisz

Sam obraz to osobny plik albo adres w internecie, a Markdown tylko na niego wskazuje. Jeśli przenosisz notatkę do innej aplikacji, przenieś też obrazy, inaczej linki przestaną działać. Pamiętaj też, że obraz z adresu internetowego jest pobierany z tamtego serwera za każdym razem, gdy notatka się wyświetla.

Cytaty

Zacznij wiersz od >, żeby kogoś zacytować albo wyodrębnić myśl. Każdy wiersz dłuższego cytatu może zaczynać się od >, a wiersz z samym > przedłuża cytat na kolejny akapit.

> Pakuj się lekko.
> I tak coś tam kupisz.
>
> (Babcia, przed każdym wyjazdem)

Kod w tekście i bloki kodu

Krótki fragment kodu, nazwę pliku albo polecenie otocz pojedynczymi grawisami (odwrotnymi apostrofami): `notatki.md`. Dla kilku wierszy wstaw trzy grawisy w wierszu przed i trzy w wierszu po. Po otwierających grawisach możesz podać nazwę języka; niektóre aplikacje używają jej do kolorowania składni.

Zmień nazwę pliku na `notatki.md`.

```
git add notatki.md
git commit -m "Pierwsza notatka"
```

git add notatki.md
git commit -m "Pierwsza notatka"

W kodzie znaki Markdown nie działają. Dlatego bloki kodu przydają się do wszystkiego, co ma zostać dokładnie w takiej postaci, w jakiej to wpisano, na przykład do polecenia albo fragmentu pliku konfiguracyjnego.

Na polskiej klawiaturze programisty grawis leży na lewo od klawisza 1, a tylda to ten sam klawisz z Shiftem. W Windows tylda bywa klawiszem martwym: jeśli nie pojawia się od razu, naciśnij po niej spację.

Linia pozioma

Trzy łączniki, gwiazdki albo podkreślniki w osobnym wierszu rysują linię oddzielającą. Zostaw nad --- pusty wiersz, bo trzy łączniki bezpośrednio pod tekstem zamieniają ten tekst w nagłówek (to starszy styl nagłówków, tzw. setext).

Plan na rano

---

Plan na popołudnie

Wyłączanie formatowania

Czasem chcesz, żeby znak pozostał znakiem. Poprzedź go ukośnikiem wstecznym \, a Markdown pokaże go dosłownie. Działa to dla znaków interpunkcyjnych, których używa Markdown, takich jak *, _, #, [, ] i ..

18\. urodziny Kuby: kupić prezent
Pomnóż 2\*3\*4.
\# to nie jest nagłówek

Bez ukośników pierwszy wiersz stałby się listą numerowaną zaczynającą się od 18, gwiazdki zamieniłyby trójkę w kursywę, a ostatni wiersz byłby nagłówkiem. Liczba z kropką na początku wiersza to w polszczyźnie częsta pułapka, bo liczebniki porządkowe zapisujemy z kropką: „18. urodziny”, „3. piętro”.

Ściągawka Markdown: wszystko w jednej tabeli

Tę tabelę warto mieć pod ręką: zbiera wszystkie elementy z poradnika. Kolumna „Efekt” jest renderowana na żywo na tej stronie, więc pokazuje dokładnie to, co wyświetli program zgodny z CommonMark i GFM.

Najczęstsze błędy w Markdown i jak je naprawić

Niemal każdy początkujący trafia na te same niespodzianki. Żadnej nie jest trudno naprawić, gdy wiesz, skąd się bierze.

Jak pisać w Markdown szybciej?

Markdown jest szybki, bo dłonie nie opuszczają klawiatury. Kilka nawyków przyspiesza go jeszcze bardziej.

Wpisuj znaki na bieżąco. Zacznij wiersz od - i masz listę, 1. daje listę numerowaną, > cytat. Po jakimś czasie przestajesz o nich myśleć, tak jak nie myślisz o wielkich literach.

Niech Enter prowadzi listę. Większość edytorów Markdown kontynuuje listę po naciśnięciu Enter: kolejny - albo numer pojawia się sam. Enter na pustym punkcie kończy listę. Tab i Shift+Tab zwykle zwiększają i zmniejszają wcięcie.

Korzystaj ze znanych skrótów. Większość aplikacji do notatek w Markdown, w tym Obsidian i Bear, przypisuje ⌘/Ctrl B do pogrubienia, a ⌘/Ctrl I do kursywy. Aplikacja sama wstawi gwiazdki wokół zaznaczenia.

Wklejaj linki na słowa. W wielu edytorach wystarczy zaznaczyć słowo i wkleić na nie adres, żeby w jednym kroku dostać [słowo](adres).

Pisz krótkie, płaskie notatki. Nagłówki porządkują dłuższą notatkę, a notatkę z dobrym tytułem łatwiej znaleźć niż idealnie sformatowaną. O tytułach, tagach i linkach między notatkami piszemy w artykule o organizowaniu notatek.

Markdown w Cappie

Cappa, aplikacja zespołu, który prowadzi ten blog, zapisuje każdą notatkę jako tekst Markdown. Edytor działa w trybie podglądu na żywo: formatowanie pojawia się w trakcie pisania, a znaki znikają z widoku, gdy kursor jest gdzie indziej. Wystarczy wejść kursorem w pogrubione słowo, a ** wracają, żeby można je było poprawić. Jeśli wolisz widzieć wszystkie znaki cały czas, włącz w ustawieniach opcję Show Markdown syntax.

Kilka uczciwych uwag o tym, jak Markdown w Cappie ma się do reszty świata:

• Podstawy są standardowe. Nagłówki, wyróżnienia, listy, linki, obrazy, cytaty, kod i linie poziome działają według CommonMark, a tabele, listy zadań i przekreślenie według GFM.
• Część dodatków pochodzi z Bear. Pojedyncza tylda, ~tekst~, oznacza w Cappie podkreślenie, tak jak w Bearze. GitHub odczyta ten sam zapis jako przekreślenie. ==tekst== to zakreślenie, a słowo w rodzaju #podróże to tag. Inne aplikacje mogą pokazać te zapisy jako zwykłe znaki.
• Wiersze zostają tam, gdzie je wpiszesz. Jak większość edytorów na żywo, Cappa pokazuje każdy wiersz osobno. Jeśli notatka ma być czytana w innym programie, oddzielaj akapity pustymi wierszami.
• Tekst wychodzi jako tekst. Możesz wyeksportować jedną notatkę albo wiele naraz do osobnych plików Markdown lub TXT, a także zaimportować pliki i foldery Markdown oraz TXT.

Cappa to prywatna aplikacja typu local-first: notatki są szyfrowane w przeglądarce, zanim trafią do synchronizacji. Nie zmienia to samego Markdown. Wyeksportowany plik .md to zwykły, czytelny tekst, więc przechowuj go w bezpiecznym miejscu.

Co dalej?

Gdy podstawy wejdą Ci w nawyk, kolejnym krokiem jest struktura. Poradnik Markdown dla zaawansowanych omawia tabele, listy zadań, przypisy, zakreślenia, wzory i diagramy, a przy każdej funkcji podaje, gdzie działa. Jeśli zastanawiasz się, jak ułożyć wiele notatek, Zettelkasten i PARA to dwie popularne metody, które dobrze współpracują ze zwykłymi plikami Markdown.

Najczęstsze pytania

Czy Markdown jest trudny do nauczenia?

Nie. Elementy używane na co dzień (nagłówki, pogrubienie, kursywa, listy i linki) opanujesz w kilkanaście minut, a wszystkie podstawy z tego poradnika mieszczą się na jednym ekranie. Trochę praktyki wymaga tylko różnica między pustym wierszem a pojedynczym Enterem.

Plik MD: co to jest i jak go otworzyć?

Plik .md to zwykły plik tekstowy zapisany w Markdown. Otworzysz go dowolnym edytorem tekstu, na przykład Notatnikiem w Windows albo TextEdit na Macu, i przeczytasz bez przeszkód. Żeby zobaczyć formatowanie, otwórz go w aplikacji obsługującej Markdown, w edytorze kodu z podglądem, takim jak VS Code, albo w serwisie typu GitHub.

Czy Markdown działa tak samo w każdej aplikacji?

Podstawy tak. Nagłówki, wyróżnienia, listy, linki, obrazy, cytaty i kod działają tak samo niemal w każdej aplikacji zgodnej z CommonMark. Tabele, listy zadań i przekreślenie pochodzą z GitHub Flavored Markdown i są szeroko obsługiwane. Zakreślenia, linki między notatkami, wzory i diagramy to rozszerzenia, które różnią się między aplikacjami.

Gwiazdki czy podkreślniki?

Oba sposoby działają dla kursywy i pogrubienia. Gwiazdki to bezpieczniejszy nawyk, bo działają także w środku wyrazu, a podkreślniki wewnątrz słowa, jak w plik_wersja_final, są celowo ignorowane. Wybierz jeden styl i trzymaj się go, żeby notatki dobrze czytały się jako zwykły tekst.

Czy da się pisać w Markdown na telefonie?

Tak. Markdown używa zwykłych znaków, więc wpiszesz go na każdej klawiaturze telefonu, a wiele aplikacji do notatek pokazuje nad klawiaturą pasek formatowania, który wstawia znaki za Ciebie. Grawis i tylda są zwykle na dodatkowej stronie symboli, a na niektórych klawiaturach grawis pojawia się po przytrzymaniu apostrofu.