Pozioma linia w Markdown: separatory, reguły i częste poprawki

Aby dodać poziomą linię w Markdown, umieść trzy łączniki w osobnym wierszu, z pustym wierszem nad nim i pod nim:

Koniec pierwszej sekcji.

---

Początek następnej sekcji.

Wynikiem jest separator między dwoma akapitami. Markdown nazywa go podziałem tematycznym; HTML reprezentuje go jako <hr>. Wklej przykład do przeglądarki Markdown, aby sprawdzić wyrenderowany dokument.

Trzy sposoby zapisu separatora

Wszystkie te formy tworzą podział tematyczny:

Źródło Markdown	Wynik
---	Pozioma linia
***	Pozioma linia
___	Pozioma linia
* * *	Pozioma linia

Użyj co najmniej trzech jednakowych łączników, gwiazdek lub podkreśleń. Spacje między znacznikami są dozwolone. Mieszanie typów znaczników, dodawanie tekstu do tego samego wiersza lub użycie tylko dwóch znaczników nie tworzy linii. Są to zasady składni ze specyfikacji podziałów tematycznych CommonMark.

Liczba łączników nie określa wizualnej szerokości linii. Wiersz z 20 łącznikami i wiersz z trzema tworzą ten sam element HTML; wygląd zależy od stylów miejsca docelowego.

Dlaczego pozioma linia zamieniła się w nagłówek?

Ten zapis nie umieszcza separatora pod tekstem „Informacje o wydaniu”:

Informacje o wydaniu
---

Tworzy nagłówek drugiego poziomu. Łączniki bezpośrednio pod tekstem akapitu mogą tworzyć nagłówek Setext, a ta interpretacja ma pierwszeństwo przed poziomą linią. Dodaj pusty wiersz, aby je rozdzielić:

Informacje o wydaniu

---

Dla sekcji dokumentu jawny nagłówek często jest czytelniejszy:

## Informacje o wydaniu

Proces importowania obsługuje teraz pliki CSV.

Używaj nagłówków Markdown do nazywania sekcji. Pozioma linia przydaje się, gdy znaczenie ma samo przejście, na przykład między listem a załącznikiem.

Dlaczego separator wyświetla się jako zwykły tekst?

Sprawdź kod źródłowy wokół linii:

Objaw	Prawdopodobna przyczyna	Poprawka
Podgląd pokazuje --- w bloku kodu	Cztery spacje na początku osobnego bloku lub niezamknięte ogrodzenie kodu	Usuń wcięcie lub zamknij ogrodzenie kodu
Podgląd pokazuje --	Tylko dwa łączniki	Użyj trzech lub więcej
Obok znaczników pojawia się tekst	Wiersz zawiera inny tekst	Umieść znaczniki w osobnym wierszu
Linia wyświetla się jako --- w zdaniu	Znaczniki są w odwrotnych apostrofach	Usuń odwrotne apostrofy, jeśli chcesz separator
Poprzedni akapit staje się nagłówkiem	Brak pustego wiersza nad ---	Wstaw pusty wiersz

Na najwyższym poziomie dokumentu podział tematyczny może poprzedzać do trzech spacji. W listach wcięcie określa też, do którego elementu należy treść, więc sprawdź otaczającą listę zamiast usuwać wszystkie spacje.

Pozioma linia różni się od podziału wiersza

Separator rozdziela sekcje. Nie służy jedynie do przenoszenia kolejnych słów do nowego wiersza.

W adresie użyj wymuszonego podziału wiersza:

120 Market Street\
San Francisco, Kalifornia

Dla nowego akapitu zostaw pusty wiersz. Dla separatora sekcji użyj --- w osobnym wierszu. Przewodnik po podziałach wiersza Markdown wyjaśnia końcowe spacje, ukośniki odwrotne i różne zachowanie nowych wierszy w plikach i komentarzach GitHub.

Separator wewnątrz cytatu blokowego

Zachowaj prefiks > w każdym wierszu, również przy separatorze i w pustych wierszach:

> Pierwotna propozycja.
>
> ---
>
> Dodatkowy kontekst od recenzenta.

Separator pozostaje wewnątrz cytatu. Usunięcie > z linii może zakończyć cytat i przenieść separator na zewnętrzny poziom dokumentu. Zobacz przykłady cytatów blokowych, aby poznać wiele akapitów i zagnieżdżone cytaty.

Separator tabeli nie jest poziomą linią

Ten wiersz należy do tabeli:

| Format | Edytowalny |
| --- | :---: |
| Markdown | Tak |

Pionowe kreski i opcjonalne dwukropki opisują kolumny. Nie wstawiają separatora na całą szerokość strony. Użyj generatora tabel Markdown, aby utworzyć tabelę, lub konwertera CSV na Markdown, gdy dane już są w arkuszu.

Poziome linie i eksportowane dokumenty

Podział tematyczny nie jest poleceniem podziału strony. Eksporter PDF lub Word ustala końce stron na podstawie układu i reguł paginacji. Nie dodawaj kolejnych łączników, oczekując, że następna sekcja zacznie się na nowej stronie.

Na stronie internetowej, której CSS kontrolujesz, wygenerowany <hr> można wystylizować w arkuszu stylów witryny. Hostowana usługa Markdown może nie pozwalać na własny CSS. Sprawdź miejsce docelowe lub wyeksportowany dokument, zwłaszcza jeśli separator niesie znaczenie, które musi przetrwać drukowanie.

Często zadawane pytania

Czy potrzebuję pustych wierszy wokół poziomej linii?

CommonMark nie wymaga ich w każdym kontekście, ale ich użycie zapobiega częstej niejednoznaczności nagłówka --- i ułatwia czytanie plików źródłowych.

Czy mogę użyć znacznika HTML hr?

<hr> działa w rendererach dopuszczających surowy HTML. Zapis Markdown --- lepiej pasuje do dokumentu Markdown. Edytor MD File Viewer usuwa znaczniki HTML wprowadzone przez użytkownika, podczas gdy składnia separatora Markdown renderuje się normalnie.

Jak pokazać trzy łączniki bez tworzenia separatora?

Dla przykładu składni zapisz kod w tekście: `---`. Dla zwykłego tekstu w osobnym wierszu poprzedź pierwszy łącznik znakiem ucieczki: \---.

Przy innych częstych sposobach formatowania miej pod ręką ściągawkę Markdown.