Wejście Markdown

Przetworzone wyjście

Przykłady podziałów wierszy Markdown

Tryb normalizacji łączy zawinięte wiersze w pojedyncze akapity. Przykład:

Zawinięte wiersze do akapitów

Wejście (zawinięte wiersze):

Wejście

Znormalizowane wyjście:

Wyjście

Użyj trybu Normalizuj akapity i przycisku Przykład powyżej.

Czym jest narzędzie do podziałów wierszy Markdown?

Markdown traktuje podziały wierszy inaczej niż HTML. Pojedynczy znak nowego wiersza często nie tworzy podziału w HTML; potrzebujesz dwóch spacji na końcu wiersza lub pustego wiersza. To narzędzie dodaje twarde podziały (dwie spacje + nowy wiersz) lub normalizuje akapity. Specyfikacja CommonMark definiuje zasady.

Przetwarzanie działa w całości w przeglądarce. Nic nie jest wysyłane na serwer. Dwa tryby: Dodaj twarde podziały (wstaw podziały wierszy po każdym wierszu) lub Normalizuj akapity (łącz zawinięte wiersze w pojedyncze akapity). Do formatowania użyj Formatera Markdown.

Jak używać tego narzędzia

1

Wklej lub wczytaj Markdown

Skopiuj swój Markdown i wklej go do lewego edytora. Możesz też kliknąć Wczytaj, aby załadować plik .md lub .markdown. Przycisk Przykład ładuje dane przykładowe.

2

Wybierz tryb

Wybierz Dodaj twarde podziały, aby wstawić podziały wierszy po każdym wierszu, lub Normalizuj akapity, aby połączyć zawinięte wiersze. Prawy panel aktualizuje się automatycznie.

3

Skopiuj lub pobierz

Użyj Kopiuj lub Pobierz. Do formatowania lub walidacji użyj Formatera Markdown lub Walidatora Markdown.

Kiedy przetwarzanie podziałów wierszy jest przydatne

Kiedy Markdown z CMS lub eksportu ma pojedyncze nowe wiersze, które nie renderują się jako podziały, dodanie twardych podziałów rozwiązuje problem. Specyfikacja GitHub Flavored Markdown i Markdown Guide omawiają zasady podziałów wierszy. Kiedy tekst ma niespójne zawijanie (np. z emaila lub kopiowania), normalizacja akapitów tworzy czyste akapity. Wiersze lub adresy często wymagają twardych podziałów.

Często zadawane pytania

Dlaczego wciśnięcie Enter nie tworzy nowej linii w Markdown?

W Markdown pojedyncze złamanie wiersza jest traktowane jako spacja — nie jako złamanie linii. Większość rendererów przestrzega specyfikacji CommonMark, która wymaga dwóch spacji na końcu wiersza (twarde złamanie) lub pustego wiersza (złamanie akapitu), aby stworzyć widoczne oddzielenie w wyrenderowanym wynik.

Jaka jest różnica między miękkim a twardym złamaniem?

Miękkie złamanie to pojedyncze złamanie wiersza w źródłowym Markdownie — renderuje się jako spacja w HTML. Twarde złamanie to dwie końcowe spacje + złamanie wiersza — renderuje się jako tag <br>. Tryb „Dodaj twarde złamania" tego narzędzia konwertuje każde pojedyncze złamanie wiersza na twarde złamanie.

Czy mogę tego używać do naprawiania Markdownu skopiowanego z Worda lub Google Docs?

Tak — to jedno z najczęstszych zastosowań. Gdy kopiujesz tekst z Worda lub Google Docs, wiersze często zawijają się przy szerokości kolumny, tworząc dziesiątki krótkich wierszy, które podczas renderowania zlewają się w ścianę tekstu. Użyj trybu Normalizuj akapity, aby połączyć te zawinięte wiersze z powrotem w prawidłowe akapity.

Czy jest kompatybilny z GitHub Flavored Markdown?

Tak. Format twardych złamań (dwie końcowe spacje) jest obsługiwany przez GitHub Flavored Markdown i wszystkie renderery zgodne z CommonMark. Tryb normalizacji generuje standardowe złamania akapitów, które działają wszędzie.

Kiedy używać twardych podziałów?

Kiedy każdy wiersz powinien być renderowany jako osobny wiersz (np. adresy, wiersze lub treść, która miała mieć pojedyncze podziały wierszy). Dodaje dwie spacje + nowy wiersz.

Powiązane narzędzia

CommonMark. Podziały wierszy CommonMark. Markdown Guide. GFM. GitHub. W3C HTML.