Markdown: tabele, listy zadań, przypisy, wzory i diagramy

Tabele i listy zadań pomagają uporządkować notatki. W Markdownie tabelę zapisuje się za pomocą pionowych kresek i wiersza rozdzielającego, a zadania oznacza się polami - [ ] i - [x]. Oba elementy należą do GitHub Flavored Markdown. Bardziej zaawansowane funkcje, takie jak wzory i diagramy, działają tylko tam, gdzie aplikacja obsługuje odpowiednie rozszerzenia.

Poniżej znajdziesz przykłady tabel, zadań, przypisów, wyróżnionych bloków, wzorów, diagramów Mermaid i linków między notatkami. Przy każdej funkcji piszemy, gdzie działa i jakie ma ograniczenia. Jeśli dopiero poznajesz składnię, zacznij od poradnika dla początkujących.

Które funkcje należą do standardu Markdowna?

CommonMark dokładnie opisuje podstawową składnię. GitHub Flavored Markdown dodaje do niej m.in. tabele i zadania. Pozostałe elementy z tego poradnika to rozszerzenia, które obsługują konkretne programy, a nawet podobnie wyglądający zapis każdy z nich może odczytać inaczej.

Tabela porównuje obsługę tych funkcji w GitHubie, Obsidianie i Cappie (stan na wrzesień 2026 roku). Przenosząc dokument, sprawdź też wersję programu i jego ustawienia.

Źródła: strony GitHuba o podstawowym formatowaniu, wzorach i diagramach oraz strony Obsidiana o składni podstawowej i zaawansowanej. Kolumna „Cappa” opisuje obecną wersję edytora.

Markdown: tabela krok po kroku

Tabela w Markdownie składa się z trzech części: wiersza nagłówka, wiersza rozdzielającego z łącznikami i wierszy z danymi. Komórki oddzielają pionowe kreski. Kreski na początku i końcu wiersza nie są obowiązkowe, ale ułatwiają czytanie tabeli w zwykłym tekście.

| Dzień | Miasto | Budżet |
| --- | --- | --- |
| Poniedziałek | Kraków | 350 zł |
| Wtorek | Wieliczka | 180 zł |

Nie musisz dopisywać spacji, żeby pionowe kreski stały dokładnie jedna pod drugą. Takie wyrównanie poprawia tylko czytelność źródła. Dokumentacja GitHuba zaleca co najmniej trzy łączniki w każdej komórce wiersza rozdzielającego, dlatego warto pisać ---.

Wyrównanie kolumn

Dwukropki w wierszu rozdzielającym ustawiają wyrównanie kolumny: :--- do lewej, :---: do środka, ---: do prawej. Do prawej warto wyrównywać liczby.

| Pozycja | Ilość | Cena |
| :--- | :---: | ---: |
| Kawa | 2 | 24,00 |
| Obwarzanek | 3 | 10,50 |

Pionowa kreska, nowy wiersz i formatowanie w komórce

W komórkach można formatować tekst: pogrubiać go, pisać kursywą, wstawiać kod i linki. Nie da się w nich natomiast umieścić elementów blokowych, takich jak listy, nagłówki czy bloki kodu. Uważaj na trzy sytuacje:

• Pionowa kreska w komórce. Napisz \|, bo inaczej kreska zacznie nową kolumnę.
• Nowy wiersz w komórce. Markdown nie ma na to składni, więc zwykle używa się znacznika HTML <br>. GitHub i wiele innych aplikacji wyświetla go jako przejście do nowego wiersza.
• Wiersze z różną liczbą komórek. W GFM brakujące komórki zostają puste, a nadmiarowe program pomija. Niektóre aplikacje są surowsze, więc w każdym wierszu trzymaj tę samą liczbę komórek.

| Polecenie | Znaczenie |
| --- | --- |
| `a \| b` | Przekaż wynik a do b |
| Spakować | Dowód<br>Ładowarkę |

Lista zadań w Markdownie: pola wyboru

Punkt listy zadań zaczyna się od - [ ], jeśli zadanie czeka na wykonanie, albo od - [x], jeśli jest już zrobione. Spacja w pustych nawiasach należy do składni. Program, który obsługuje to rozszerzenie GFM, pokaże w tym miejscu pole wyboru.

- [x] Kupić bilety
- [ ] Zarezerwować stolik
    - [x] Wybrać restaurację
    - [ ] Zadzwonić przed piątkiem
- [ ] Pobrać mapy offline

W wielu edytorach zadanie zaznacza się kliknięciem, a program sam zmienia zapis. Niewykonane zadania da się też znaleźć, wyszukując dosłowny ciąg - [ ]. To, czy można przeszukać naraz wiele plików, zależy od edytora.

W Cappie kliknięcie pola przełącza zadanie, /todo na początku wiersza wstawia nowe, a Enter dodaje pod spodem kolejne puste pole. Wykonane zadania są przygaszone, a nie przekreślone. Opcjonalne ustawienie Sort completed todos przenosi w każdej liście wykonane punkty pod niewykonane.

Przypisy w Markdownie

Przypis pozwala dodać źródło lub uwagę bez przerywania głównego tekstu. W treści wstawiasz znacznik, np. [^1], a samą treść przypisu zapisujesz osobno, zwykle na końcu dokumentu. Program, który obsługuje przypisy, numeruje je i wyświetla pod tekstem.

Kraków ma ponad 700 lat praw miejskich.[^lokacja] Hejnał gra się co godzinę.[^hejnal]

[^lokacja]: Lokacja na prawie magdeburskim w 1257 roku.
[^hejnal]: Z wieży kościoła Mariackiego, w cztery strony świata.

Etykietą może być liczba albo słowo; [^hejnal] łatwiej zapamiętać niż [^7]. Przypisy nie należą ani do CommonMark, ani do specyfikacji GFM, ale obsługuje je GitHub (poza wiki), a także Obsidian, Bear i większość aplikacji do notatek.

W Cappie polecenie /footnote wstawia znacznik z kolejnym wolnym numerem, a na końcu notatki miejsce na treść przypisu. Tekst zastępczy jest zaznaczony, więc od razu możesz pisać. Polecenie Renumber footnotes w menu More actions numeruje przypisy od nowa w kolejności, w jakiej pierwszy raz pojawiają się w tekście.

Callouty, czyli wyróżnione bloki

Callout (na GitHubie nazywany alertem) to wyróżniony blok zapisany składnią cytatu. Jego pierwszy wiersz określa rodzaj informacji. GitHub zna pięć rodzajów: NOTE, TIP, IMPORTANT, WARNING i CAUTION.

> [!WARNING]
> W poniedziałki muzeum jest zamknięte.

Obsidian obsługuje tę samą składnię, a do tego więcej rodzajów i własne tytuły. Cappa obsługuje pięć rodzajów znanych z GitHuba, zapisanych wielkimi literami jak wyżej; polecenie /callout pokazuje je w menu bloków. Aplikacja bez calloutów wyświetli taki blok jako zwykły cytat z [!WARNING] w pierwszym wierszu, więc nadal da się go przeczytać.

Wyróżnianie tekstu kolorem

Zapis ==sprawdzić datę== oznacza wyróżnienie tłem w aplikacjach, które obsługują to rozszerzenie, m.in. w Obsidianie, Bearze, iA Writerze i Cappie. GitHub pokazuje znaki równości dosłownie. Jeśli zależy Ci na zgodności z większą liczbą programów, użyj pogrubienia.

Spotkanie przy ==wejściu północnym==.

Cappa pozwala dodatkowo wybrać kolor. Atrybut w rodzaju {color=red} tuż po zamykającym == ustawia jeden z pięciu kolorów: green, red, blue, yellow albo purple. Bez atrybutu zakreślenie ma domyślny kolor motywu. Atrybutu nie trzeba wpisywać ręcznie: kliknij zakreślenie prawym przyciskiem myszy i wybierz kolor albo Remove highlight.

==Potwierdzone=={color=green}
==Po terminie=={color=red}
==Pomysł=={color=blue}

Wzory w Markdownie

Wiele aplikacji zapisuje wzory składnią wywodzącą się z TeX-a, systemu do składu tekstów matematycznych. Pojedyncze znaki dolara otaczają wzór w tekście, a pary $$ w osobnych wierszach wyznaczają blok. Do wyświetlania wzorów GitHub i Obsidian używają biblioteki MathJax. Nie znaczy to jednak, że poradzą sobie z dowolnym dokumentem czy każdym pakietem TeX-a.

Pole koła to $\pi r^2$.

$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

Programy różnie rozpoznają znaki dolara. W Cappie wzór w tekście nie może mieć spacji tuż po otwierającym $ ani tuż przed zamykającym, a zaraz po zamykającym $ nie może stać cyfra. Podobne reguły stosuje Pandoc; dzięki nim ceny w rodzaju „$5 i $10” nie są mylone ze wzorami. Bloki $$ zapisuj w osobnych wierszach.

Diagram Mermaid w Markdownie

Mermaid zamienia krótki opis tekstowy w diagram. Opis zapisujesz w bloku kodu oznaczonym językiem mermaid. Aplikacja, która nie obsługuje Mermaida, pokaże po prostu tekst, a ten nadal czytelnie opisuje diagram.

flowchart LR
  A[Skrzynka] --> B{Do zrobienia?}
  B -->|Tak| C[Notatka projektu]
  B -->|Nie| D[Archiwum]

Pierwszy wiersz określa typ i kierunek diagramu: flowchart LR to układ od lewej do prawej, a TD z góry na dół. Nawiasy kwadratowe tworzą prostokąt, klamrowe romb, a zapis -->|etykieta| strzałkę z opisem. Kolejność wymienianych wiadomości dobrze pokazuje diagram sekwencji:

sequenceDiagram
  Anna->>Hotel: Czy możemy zameldować się wcześniej?
  Hotel-->>Anna: Tak, po 11:00

Diagramy Mermaid wyświetlają GitHub, Obsidian i wiele innych narzędzi, ale każde korzysta z własnej wersji biblioteki, więc nowsze typy diagramów nie wszędzie zadziałają.

Cappa rysuje diagramy na Twoim urządzeniu i nie wysyła ich do zewnętrznej usługi. Obsługuje flowchart i graph, sequenceDiagram, stateDiagram, classDiagram, erDiagram oraz xychart-beta. Nazwa typu musi stać w pierwszym wierszu. Krótszej nazwy xychart, której używa aktualna dokumentacja Mermaida, ten edytor nie rozpoznaje.

Ze względów bezpieczeństwa Cappa nie pokazuje podglądu diagramów, które zawierają dyrektywy konfiguracyjne, klikalne odnośniki albo etykiety w HTML. Ogranicza też ich rozmiar i złożoność, m.in. do 12 000 znaków i 240 wierszy, a gotowy obraz przed wyświetleniem dodatkowo oczyszcza. Polecenie /mermaid wstawia przykład, Edit source otwiera kod diagramu, a w ustawieniach można wyłączyć podgląd.

Linki między notatkami (wikilinki)

Wikilink odsyła do innej notatki zapisem [[Lista pakowania]]. Ta konwencja pochodzi z oprogramowania wiki i jest popularna w aplikacjach do notatek, m.in. w Obsidianie. Nie należy do podstawowej składni Markdowna, więc w zwykłym pliku na GitHubie zostanie tekstem w nawiasach.

[[Lista pakowania]]                    link do notatki
[[Lista pakowania#Dokumenty]]          link do nagłówka w tej notatce
[[Lista pakowania#^paszport]]          link do bloku oznaczonego ^paszport
[[Lista pakowania|co zabrać]]          link z własnym tekstem

Identyfikator bloku to daszek i krótka nazwa, np. ^paszport, dopisane na końcu wiersza, do którego chcesz linkować. Dokumentacja linków Obsidiana opisuje te same formy, więc notatki zapisane w ten sposób dobrze przenoszą się między Obsidianem a Cappą.

Cappa obsługuje wszystkie cztery formy. Po wpisaniu [[ podpowiada tytuły notatek, przy czym wielkość liter nie ma znaczenia. Kliknięcie linku do notatki, która jeszcze nie istnieje, pozwala ją utworzyć. Gdy zmieniasz nazwę notatki z jej menu, Cappa poprawia prowadzące do niej wikilinki w pozostałych notatkach (zablokowanych notatek nie zmienia). Zakładka Links w szczegółach notatki pokazuje notatki, które linkują do bieżącej.

Jeśli notatka ma działać także na GitHubie, użyj zwykłego linku do pliku, np. [Lista pakowania](lista-pakowania.md). Jak łączyć linki z tagami i folderami, opisujemy w artykule o organizowaniu notatek.

Metadane YAML na początku notatki

Front matter to blok metadanych na początku pliku. Zwykle zapisuje się go w formacie YAML między dwoma wierszami ---. Korzystają z niego m.in. generatory stron internetowych i Obsidian, który pokazuje metadane jako właściwości (properties).

---
title: Wyjazd do Krakowa
tags: [podróże, małopolska]
aliases: [Kraków 2026]
created: 2026-05-02T09:30:00+02:00
---

Tu zaczyna się notatka.

Program rozpozna front matter tylko wtedy, gdy blok stoi na samym początku pliku i spełnia reguły tego programu. W dalszej części dokumentu --- może oznaczać linię poziomą albo podkreślenie nagłówka setext, zależnie od kontekstu. GitHub wyświetla obsługiwane metadane jako tabelę nad treścią.

Cappa zostawia front matter jako zwykły blok na początku notatki i nie formatuje go jako Markdown. Polecenie /yaml wstawia pusty blok. Przy imporcie (Import from Obsidian or Bear) Cappa odczytuje pola title, tags i aliases oraz daty utworzenia i zmiany. Tagi trafiają do notatki jako zwykłe #tagi, aliasy pomagają podczas importu dopasować wikilinki do notatek, a daty zostają zachowane, jeśli zawierają strefę czasową.

Zwijanie sekcji

Podstawowa składnia Markdowna nie przewiduje zwijania sekcji. GitHub pozwala użyć znaczników HTML <details> i <summary>, ale nie wszystkie aplikacje pokazują je jako rozwijany blok. Cappa ich tak nie wyświetla.

Aplikacje do notatek zwykle rozwiązują to w samym edytorze. W Cappie możesz zwinąć sekcję pod nagłówkiem albo punkt listy, który ma podpunkty. Najedź myszą na lewy margines obok nagłówka lub punktu i kliknij kontrolkę, która się pojawi. Możesz też nacisnąć ⌘/Ctrl ', żeby zwinąć sekcję, w której jest kursor. Polecenia Fold all sections i Unfold all sections są dostępne w Quick Open (⌘/Ctrl K).

Jak uporządkować cały zbiór, a nie tylko pojedynczą notatkę, opisujemy w porównaniu metod Zettelkasten i PARA.

Najczęstsze pytania

Jak zrobić nowy wiersz w komórce tabeli Markdown?

W tabeli GFM możesz użyć znacznika <br>, jeśli program obsługuje ten fragment HTML. W Cappie Enter w komórce wstawia go automatycznie.

Dlaczego moja tabela w Markdownie się nie wyświetla?

Sprawdź, czy aplikacja obsługuje tabele i czy pod wierszem nagłówka jest wiersz rozdzielający. W każdej jego kolumnie wpisz co najmniej trzy łączniki, przed tabelą zostaw pusty wiersz, a pionowe kreski wewnątrz komórek zapisuj jako \|. W Cappie każdy wiersz z danymi musi też mieć właściwą liczbę komórek.

Czy w Markdownie da się zrobić pola wyboru?

Tak, służą do tego listy zadań: - [ ] oznacza zadanie otwarte, a - [x] wykonane. Pochodzą z GitHub Flavored Markdown, więc GitHub i większość aplikacji do notatek pokazuje je jako pola wyboru, które można klikać albo tylko oglądać.

Czy GitHub obsługuje diagramy Mermaid i wzory?

Tak. GitHub wyświetla bloki kodu mermaid jako diagramy, a wzory między $ lub $$ składa za pomocą MathJax. Nie obsługuje natomiast ==zakreśleń== ani [[wikilinków]] w zwykłych plikach Markdown.

Czy zakreślenie wygląda tak samo w każdej aplikacji?

Nie. ==tekst== to rozszerzenie: obsługują je Obsidian, Bear, iA Writer i Cappa, ale GitHub już nie. Kolorowe zakreślenia w rodzaju ==tekst=={color=red} to konwencja Cappy, więc inne programy pokażą je jako dosłowny tekst.