Cytaty blokowe Markdown: cytaty, wiele akapitów i listy
Twórz cytaty Markdown za pomocą >, zagnieżdżaj bloki i cytuj wiele akapitów. Odróżniaj alerty GitHub od przenośnej składni przed eksportem do Worda.
Cytat blokowy Markdown zaczyna się od > i następującej po nim spacji. Umieszczaj znacznik na początku każdego cytowanego wiersza, aby źródło było łatwe do czytania i edycji.
> Poprawiona instrukcja instalacji jest gotowa do przeglądu.
Wynikiem jest cytowany akapit, a nie blok kodu. Jego obramowanie, wcięcie i kolor zależą od motywu strony lub dokumentu. Tekst cytatu pozostaje zwykłym Markdown, więc może zawierać wyróżnienia, linki, listy i inne struktury dokumentu.
Wypróbuj przykłady w przeglądarce Markdown, a następnie wyeksportuj dokument za pomocą konwertera Markdown do Worda, gdy potrzebujesz edytowalnej kopii do przeglądu.
Cytowanie akapitu w kilku wierszach źródła
W dłuższym cytacie powtarzaj znacznik:
> Poprawiona instrukcja instalacji jest gotowa do przeglądu.
> Sprawdź wymagania wstępne przed zatwierdzeniem wydania.
Te dwa wiersze źródła tworzą w podglądzie tej witryny jeden akapit. Nowy wiersz w źródle niekoniecznie wymusza widoczny podział wiersza. Jeśli tekst musi pozostać w dwóch wierszach, dodaj jawny podział:
> Przegląd dokumentacji\
> Przypisany osobie odpowiedzialnej za wydanie
Ukośnik odwrotny należy umieścić przed znakiem nowego wiersza; następny wiersz nadal zaczyna się od znacznika cytatu. Różnicę między wymuszonymi podziałami a podziałami akapitów opisuje artykuł o podziałach wierszy Markdown.
Wiele akapitów w jednym cytacie
Umieść znacznik cytatu w pustym wierszu między akapitami:
> Pierwsza wersja robocza opisuje proces instalacji.
>
> Druga wersja dodaje kroki rozwiązywania problemów i przykłady.
Powstaje jeden cytat blokowy zawierający dwa akapity. Zachowanie > w wierszu rozdzielającym uwidacznia zamierzone grupowanie, szczególnie gdy ktoś później edytuje fragment.
Aby wrócić do własnego tekstu, zostaw pusty wiersz i kontynuuj bez znacznika:
> W przeglądzie poproszono o skrócenie sekcji instalacji.
Przenieśliśmy szczegółowe uwagi konfiguracyjne do dodatku.
Nie usuwaj > z wiersza kontynuacji bez dodania pustego wiersza. Niektóre parsery Markdown traktują to jako niejawną kontynuację cytowanego akapitu. Zachowanie to opisuje specyfikacja cytatów blokowych CommonMark. Jawne znaczniki i wyraźny pusty wiersz ułatwiają wspólną pracę nad tekstem.
Wyróżnienia, linki i wskazanie źródła
W cytacie blokowym można stosować zwykłe formatowanie śródtekstowe:
> **Uwaga z przeglądu:** Kroki migracji wymagają działającego przykładu.
> Zobacz [listę kontrolną wydania](https://example.com/checklist).
>
> Opinia z przeglądu dokumentacji, wrzesień 2026.
Markdown nie przypisuje ostatniemu wierszowi specjalnej roli źródła cytatu. To zwykła treść akapitu wewnątrz cytatu. Podaj źródło, autora i link, gdy są potrzebne, oraz sprawdź uprawnienia przed odtworzeniem czyjegoś fragmentu.
Cytat blokowy nie dodaje też dosłownych cudzysłowów. Wpisz je samodzielnie, jeśli wymaga ich końcowy dokument. W przypadku krótkiego cytatu osadzonego we własnym zdaniu zwykłe cudzysłowy mogą wystarczyć bez tworzenia osobnego bloku.
Zagnieżdżenie cytatu lub dodanie listy
Użyj dodatkowego poziomu > dla cytowanego materiału wewnątrz zewnętrznego cytatu:
> Recenzent podsumował wcześniejszą prośbę:
>
> > Dodaj kompletny przykład pliku konfiguracyjnego.
>
> Zaktualizowana wersja robocza zawiera już ten przykład.
W raporcie zachowuj niewielką głębokość zagnieżdżenia. Głęboko zagnieżdżone cytaty zmniejszają szerokość dostępną dla tekstu, co może pogarszać czytelność układu PDF i Worda.
Lista wewnątrz cytatu zachowuje znacznik w każdym wierszu:
> Przegląd wskazał dwie zmiany:
>
> - Wyjaśnij wymagane uprawnienia.
> - Dodaj sekcję rozwiązywania problemów.
W odwrotnej strukturze, czyli cytacie wewnątrz listy, wcięcie powinno zaczynać się pod tekstem elementu:
- Opinia o dokumentacji
> Dodaj sekcję rozwiązywania problemów przed publikacją.
- Lista kontrolna wydania
Jeśli cytat pojawia się poza elementem, porównaj jego wcięcie z przykładami w poradniku wcięć Markdown.
Alerty GitHub wymagają obsługi w miejscu docelowym
GitHub obsługuje specjalne alerty oparte na składni cytatów, w tym tę postać:
> [!NOTE]
> Utwórz kopię zapasową konfiguracji przed jej zmianą.
GitHub opisuje obsługiwane typy w dokumentacji alertów. Kolory i ikony alertów są funkcjami platformy, a nie właściwością każdego cytatu Markdown.
Mechanizm renderowania tej witryny nie dodaje stylów alertów GitHub. Przykład pozostaje cytatem blokowym z widoczną etykietą [!NOTE]. Jeśli dokument ma być czytelny w różnych miejscach, użyj wyraźnej pogrubionej etykiety:
> **Uwaga:** Utwórz kopię zapasową konfiguracji przed jej zmianą.
Dzięki temu znaczenie pozostaje zrozumiałe bez specjalnego rozszerzenia alertów. To samo podejście działa dla ostrzeżenia, decyzji z przeglądu lub uwagi redakcyjnej.
Rozwiązywanie problemów z cytatami przed eksportem
Jeśli > pojawia się dosłownie, sprawdź, czy przykład znajduje się między grawisami, w ogrodzonym bloku kodu lub w bloku kodu utworzonym wcięciem. Te konteksty służą do pokazywania tekstu źródłowego. Ukośnik odwrotny przed znacznikiem również wyłącza jego specjalne znaczenie.
Jeśli cytat obejmuje zbyt dużo tekstu, dodaj pusty wiersz przed akapitem, który ma być poza cytatem. Jeśli trudno śledzić zagnieżdżony materiał, zmniejsz zagnieżdżenie i dodaj wskazanie źródła jako zwykły akapit.
Na koniec otwórz wyeksportowany DOCX i sprawdź długie cytaty oraz cytowane listy. Lewe obramowanie w przeglądarce i style akapitów w dokumencie Worda mogą się różnić. Użyj narzędzia Markdown do HTML, aby sprawdzić strukturę pośrednią, gdy trzeba odróżnić problem formatowania źródła od problemu stylu eksportu.