Jak złamać wiersz w Markdown:dwie spacje, ukośnik wsteczny lub znacznik br.

Dlaczego Markdown ignoruje twój nowy wiersz

Markdown skleja linie akapitu. Jeśli napiszesz

Roses are red
Violets are blue

czytelnik zobaczy jeden akapit, Róże są czerwone Fiołki są niebieskie. Nowa linia w źródle to miękkie złamanie: miejsce, w którym tekst został zawinięty, a nie miejsce, w którym czytelnik ma zobaczyć przerwę. Pozwala zawijać długie linie w edytorze bez zmiany wyglądu strony.

Pusta linia jest inna. Kończy akapit i zaczyna nowy, z odstępem między nimi. Najczęściej to właśnie takiej przerwy chcesz.

Trzy sposoby wymuszenia złamania wiersza

Wymuszone złamanie, zwane twardym, zostawia tekst w tym samym akapicie i zaczyna następną linię.

1. Dwie spacje na końcu linii

   Wpisz co najmniej dwie spacje przed naciśnięciem Entera. Działa wszędzie, ale spacji nie widać, a niektóre edytory i ustawienia Gita je obcinają.

2. Ukośnik wsteczny na końcu linii

   Wstaw \ jako ostatni znak, bez spacji po nim. Jest widoczny i przetrwa obcinanie. Należy do CommonMark i GitHub Flavored Markdown, choć kilka starszych aplikacji go nie zna.

3. Znacznik HTML br

   Zakończ linię znacznikiem <br> (lub <br/>). Działa w prawie każdej aplikacji przyjmującej HTML w linii. To też jedyny sposób na złamanie linii wewnątrz komórki tabeli.

Two spaces after this line  
comes out on a new line.

A backslash ends this one\
and breaks it too.

A tag also works.<br>
Third line.

Wszystkie trzy dają ten sam wynik:

Dwie spacje po tej linii
wychodzą w nowej linii.

Którego użyć?

• Nowy akapit (pusta linia) dla wszystkiego, co jest osobną myślą. To najbardziej przenośny wybór.
• Ukośnik wsteczny, gdy potrzebujesz przerwy w środku akapitu, np. w adresie lub wierszu, a aplikacja stosuje CommonMark.
• Znacznik br w komórce tabeli lub gdy nie masz pewności, że aplikacja obsługuje pozostałe dwa.
• Dwie spacje tylko wtedy, gdy masz pewność, że nic ich nie obetnie.

Złamania nie działają wewnątrz fragmentu kodu, a złamanie na samym końcu akapitu nic nie robi. Jeśli chcesz pustej przestrzeni, użyj pustej linii lub nagłówka, a nie stosu znaczników <br>.

Przykłady: adres, wiersz, pozycja listy

Twarde złamanie pasuje do tekstu, w którym liczy się sama linia, jak adres pocztowy:

Jane Smith221B Baker StreetLondon

Jan Kowalski
ul. Długa 12
00-238 Warszawa

Wewnątrz pozycji listy zakończ linię złamaniem i zrób wcięcie następnej linii tak, by pokrywała się z tekstem pozycji:

- Pack the bags  and lock the door
- Leave at eight

Jeśli każda linia długiego tekstu potrzebuje złamania, tekst to prawdopodobnie lista lub blok kodu, a Markdown ma składnię dla obu.

Gdy złamanie wiersza nadal nie działa

• Jedna spacja na końcu. Potrzebujesz dwóch lub więcej.
• Spacja po ukośniku wstecznym. Ukośnik musi być ostatnim znakiem linii.
• Edytor obcina końcowe spacje przy zapisie. Przejdź na ukośnik wsteczny lub znacznik br.
• Ten sam tekst wygląda inaczej w dwóch miejscach. Niektóre aplikacje, jak pola zgłoszeń i komentarzy na GitHubie, zachowują pojedyncze nowe linie jako złamania, a plik Markdown na GitHubie nie. Wymuszone złamanie wygląda tak samo w obu.
• Tekst wewnątrz pozycji listy lub cytatu. Zostaw złamanie na końcu linii, a następną linię wcinaj zgodnie z pozycją.

Najszybciej sprawdzisz to, otwierając plik w czytniku. DotMD stosuje te zasady: pojedyncza nowa linia skleja linie, a dwie spacje, ukośnik wsteczny lub <br> łamią linię. Czytanie jest bezpłatne, a w DotMD Editor podgląd na żywo pokazuje wynik podczas pisania.

Pytania o łamanie wierszy w Markdown

Więcej pytań