Dlaczego zniknęły moje łamania linii?

Pojedynczy znak nowej linii traktowany jest jak spacja. Użyj pustej linii dla nowego akapitu albo zakończ linię dwiema spacjami, żeby wymusić łamanie w obrębie akapitu. Część rendererów ma opcję „łam na nowej linii”, która to zmienia.

Dlaczego moja tabela się nie renderuje?

Tabele wymagają GFM. Sprawdź, czy wiersz rozdzielający nagłówek ma co najmniej trzy myślniki na kolumnę (|---|---|) i czy docelowa platforma w ogóle obsługuje to rozszerzenie.

Podglądaj Markdown w czasie rzeczywistym.

Markdown

Podgląd

Hello World

This is a bold and italic text example.

Features

Item one

Item two

Item three

Code

Use console.log() to debug.

First step

Second step

Third step

Wszystkie obliczenia wykonywane są lokalnie w przeglądarce. Dane nie są wysyłane na serwer.

Wyniki mają charakter informacyjny. Potwierdź je w innych źródłach.

Markdown i dlaczego gdzie indziej wygląda inaczej

Markdown to nie jeden język. CommonMark jest ścisłym rdzeniem; GitHub Flavored Markdown dokłada do niego tabele, przekreślenia, listy zadań i automatyczne linki. Większość niespodzianek bierze się z pisania w jednej odmianie, a publikowania w innej.

Jak to działa

Renderuje tekst na żywo w trakcie pisania, więc widzisz strukturę, zamiast ją sobie wyobrażać.
Obsługuje popularne rozszerzenia GFM — tabele, bloki kodu, listy zadań — obok rdzenia CommonMark.
Działa w całości w Twojej przeglądarce, więc wklejony tu szkic nigdzie nie jest wysyłany.

rdzeń CommonMark   nagłówki, wyróżnienia, listy, linki, cytaty, kod
GFM dokłada        tabele, ~~przekreślenie~~, listy zadań, autolinki
żaden nie ma       podkreślenia, koloru tekstu, rozmiaru, wyśrodkowania

twardy łamacz      zakończ linię dwiema spacjami albo użyj pustej linii

Przykład z liczbami

Dwie rzeczy mylone najczęściej: łamanie linii i listy zagnieżdżone.

linia pierwsza
linia druga → renderuje się jako jeden akapit: „linia pierwsza linia druga”
linia pierwsza·· → dwie spacje na końcu wymuszają łamanie
lista zagnieżdżona: wcięcie dziecka dokładnie na szerokość znacznika rodzica
- rodzic / ··- dziecko działa; - rodzic / · - dziecko często nie

Pojedynczy znak nowej linii nie jest w Markdownie łamaniem — jest spacją. Ta jedna zasada odpowiada za większość zdziwienia „dlaczego formatowanie mi się skleiło”.

Jak czytać wynik

Tabele to rozszerzenie GFM, a nie rdzeń Markdowna. Jeśli Twoje renderują się jako dosłowne kreski pionowe, docelowy renderer obsługuje tylko CommonMark — częste w starszych wiki i części generatorów stron.
Wcięcie list zagnieżdżonych musi odpowiadać szerokości znacznika rodzica. Pod znacznikiem „- ” działają dwie spacje; pod „1. ” potrzebne są trzy. Mieszane wcięcia to typowa przyczyna spłaszczonej listy.
Surowy HTML dopuszcza specyfikacja, ale większość hostowanych rendererów usuwa go dla bezpieczeństwa. Nie licz na to, że <div> przetrwa na GitHubie, w CMS-ie czy w polu komentarza.
Nie ma podkreślenia ani sposobu na ustawienie koloru czy rozmiaru. Jeśli tego potrzebujesz, potrzebujesz HTML-a albo innego formatu — Markdown celowo kończy się na strukturze.

Częste pytania

Dlaczego zniknęły moje łamania linii?: Pojedynczy znak nowej linii traktowany jest jak spacja. Użyj pustej linii dla nowego akapitu albo zakończ linię dwiema spacjami, żeby wymusić łamanie w obrębie akapitu. Część rendererów ma opcję „łam na nowej linii”, która to zmienia.
Dlaczego moja tabela się nie renderuje?: Tabele wymagają GFM. Sprawdź, czy wiersz rozdzielający nagłówek ma co najmniej trzy myślniki na kolumnę (|---|---|) i czy docelowa platforma w ogóle obsługuje to rozszerzenie.

Podglad Markdown