Podziały wierszy Markdown: nowe wiersze, akapity i komórki tabel
Dodaj nowy wiersz w Markdown ukośnikiem odwrotnym, dwiema spacjami lub pustym wierszem. Popraw podziały w README, listach i komórkach tabel przed eksportem do Worda.
Aby rozpocząć nowy wiersz wewnątrz akapitu Markdown, umieść ukośnik odwrotny na końcu pierwszego wiersza, a następnie naciśnij Enter. Aby rozpocząć oddzielny akapit, pozostaw pusty wiersz. Te sposoby tworzą różne struktury dokumentu, co ma znaczenie przy późniejszym eksporcie README, adresu lub raportu do Worda.
Zespół dokumentacji\
ul. Przykładowa 42\
Portland, Oregon
Adres pozostaje jednym akapitem wyświetlanym w trzech wierszach. Wklej go do podglądu Markdown, aby porównać go z poniższymi przykładami.
Wybierz potrzebny rodzaj podziału
| Zamierzony rezultat | Źródło Markdown | Typowe zastosowanie |
|---|---|---|
| Kontynuowanie tego samego akapitu | Zwykły znak nowego wiersza | Dzielenie długich wierszy źródła |
| Rozpoczęcie kolejnego wiersza w tym samym akapicie | Ukośnik odwrotny, a następnie Enter | Adresy i krótkie wiersze poetyckie |
| Rozpoczęcie nowego akapitu | Pusty wiersz | Oddzielanie myśli w artykule |
| Podział wewnątrz komórki tabeli | <br>, jeśli obsługiwany jest HTML | Dwie krótkie etykiety w jednej komórce |
Podział wiersza nie tworzy podziału strony. Jeśli kolejna sekcja eksportowanego dokumentu powinna zaczynać się na nowej kartce, zobacz osobny poradnik podziałów stron Markdown.
Dlaczego Enter może wyglądać jak spacja
Wypróbuj takie źródło:
Wersja robocza jest gotowa.
Recenzent może otworzyć ją dzisiaj.
W podglądzie tej witryny oba zdania należą do jednego akapitu i wyświetlają się ciągiem. Znak nowego wiersza jest przydatny w pliku źródłowym, ale nie wymusza rozpoczęcia nowego wyświetlanego wiersza w przeglądarce. Przeglądarka nadal może zawijać tekst zgodnie z dostępną szerokością.
Teraz wstaw pusty wiersz:
Wersja robocza jest gotowa.
Recenzent może otworzyć ją dzisiaj.
Podgląd tworzy dwa akapity. Używaj tej wersji, gdy drugie zdanie rozpoczyna nową myśl. Kilka pustych wierszy nie zapewnia dodatkowego odstępu pionowego; styl akapitów zależy od mechanizmu renderowania lub szablonu dokumentu.
Ukośnik odwrotny lub dwie spacje na końcu
CommonMark definiuje dwie spacje przed znakiem nowego wiersza oraz ukośnik odwrotny przed tym znakiem jako składnię wymuszonego podziału wiersza wewnątrz akapitu. Obie formy opisują przykłady wymuszonych podziałów wierszy CommonMark.
Wersja z ukośnikiem odwrotnym jest widoczna podczas przeglądania pliku:
Przygotowane przez zespół dokumentacji\
Sprawdzone przez osobę odpowiedzialną za wydanie
Alternatywnie wpisz dokładnie dwie spacje po słowie dokumentacji, a następnie naciśnij Enter. W wielu edytorach spacje te są niewidoczne i mogą zostać usunięte przez automatyczne czyszczenie białych znaków na końcach wierszy. Jeśli podział znika po zapisaniu, sprawdź ustawienia białych znaków lub użyj ukośnika odwrotnego.
Nie wpisuj dwóch znaków \n w zwykłym tekście, oczekując podziału. To konwencja używana w ciągach znaków w programowaniu, a nie nowy wiersz Markdown. Unikaj też ukośnika odwrotnego na samym końcu akapitu: po wymuszonym podziale musi nastąpić kolejny wiersz treści tego akapitu.
Komentarze GitHub i pliki README zachowują się inaczej
Dokumentacja podziałów wierszy GitHub rozróżnia pliki .md w repozytoriach od zgłoszeń, pull requestów i dyskusji. W tych miejscach rozmów zwykłe znaki nowego wiersza mogą wyświetlać się jako podziały, podczas gdy README wymaga jawnej składni wymuszonego podziału.
To wyjaśnia, dlaczego tekst skopiowany ze zgłoszenia może wyglądać inaczej w README. Sprawdź plik docelowy, zamiast zakładać, że wszystkie obszary jednej witryny stosują identyczne reguły formatowania.
Zachowaj kontynuację wewnątrz elementu listy
Wcięcie kontynuacji powinno odpowiadać początkowi tekstu elementu:
- Informacje o wydaniu\
Uwzględnij instrukcje migracji.
- Instrukcja instalacji
Tutaj pierwszy element ma dwa wyświetlane wiersze. Drugi element pozostaje oddzielny. Aby utworzyć osobny akapit w pierwszym elemencie, użyj pustego wiersza i zachowaj wcięcie kontynuacji:
- Informacje o wydaniu
Uwzględnij instrukcje migracji i znane problemy.
- Instrukcja instalacji
Poradnik wcięć omawia listy numerowane, zagnieżdżone wypunktowania oraz kod wewnątrz elementu.
Dodaj nowy wiersz w komórce tabeli Markdown
Wiersz tabeli GFM powinien zajmować jeden wiersz źródła. Naciśnięcie Enter wewnątrz jego treści może go rozdzielić. W mechanizmach renderowania dopuszczających podziały HTML użyj tego wzorca:
| Dokument | Osoby odpowiedzialne |
| --- | --- |
| Informacje o wydaniu | Autor<br>Recenzent |
Podgląd tej witryny obsługuje ten przykład. Miejsce docelowe usuwające HTML może usunąć podział lub pokazać znacznik, więc sprawdź platformę przed zastosowaniem tego sposobu w całym dokumencie. Gdy komórka potrzebuje kilku akapitów, lista poza tabelą jest często łatwiejsza w utrzymaniu.
Do danych tabelarycznych używaj generatora tabel Markdown, a wyrównanie i zabezpieczanie pionowych kresek opisuje poradnik składni tabel.
Sprawdź wyeksportowany dokument
Przed użyciem konwertera Markdown do Worda przetestuj krótki przykład zawierający zwykły znak nowego wiersza, jawny wymuszony podział i pusty wiersz. Podgląd powinien pokazać odpowiednio jeden ciągły akapit, wymuszony podział wiersza oraz dwa osobne akapity.
Otwórz pobrany DOCX i sprawdź adres, listy i tabelę. Szerokość strony i style akapitów Worda mogą zmieniać zawijanie, nawet gdy same podziały są prawidłowe. Najpierw popraw strukturę Markdown; końcową typografię dostosuj w Wordzie, gdy wymaga tego określony szablon dokumentu.