Co to jest Markdown? Pełne wyjaśnienie lekkiego języka znaczników
Szybka odpowiedź
Markdown to plain text język znaczników używający prostych symboli: # dla headings, ** dla bold, * dla italic, - dla list, [text](url) dla linków. Jest zaprojektowany do bycia czytelnym jako plain text i konwertowalnym do HTML. Użyj naszego darmowego Markdown to HTML Converter.
Wstęp
Markdown to lekki język znaczników stworzony przez Johna Grubera w 2004, który używa formatowania plain text do produkcji ustrukturyzowanych dokumentów. Celem jest czytelność —tekst źródłowy Markdown powinien wyglądać jak to co reprezentuje, bez wizualnego clutter tagów HTML. Markdown jest standardem dla README na GitHub, dokumentacji, blogpostów i aplikacji notatkowych jak Obsidian i Notion.
Krok po kroku
-
Naucz się podstawowej składni
Nagłówki: # H1, ## H2, ### H3. Pogrubienie: **tekst**. Kursywa: *tekst*. Listy: - pozycja lub 1. pozycja. Linki: [tekst](url). Obrazy: . Kod: ```inline`' lub ```block```. Cytaty blokowe: > cytat. Linia pozioma: ---.
-
Zrozum filozofię
Markdown zaprojektowano tak, aby można go było odczytać jako zwykły tekst. Źródło powinno wyglądać podobnie do końcowego renderowanego wyniku — **pogrubienie** wygląda jak pogrubienie, # Nagłówek wygląda jak nagłówek. Kontrastuje to z HTML, gdzie <strong>pogrubienie</strong> i <h1>Nagłówek</h1> są wizualnie zaśmiecone.
-
Poznaj warianty
Oryginalny Markdown (specyfikacja Grubera) jest minimalny. CommonMark to znormalizowana, dobrze określona wersja. GitHub Flavoured Markdown (GFM) dodaje tabele, przekreślenia, listy zadań i automatyczne linki. MDX umożliwia osadzanie komponentów React w Markdown. Większość narzędzi obsługuje GFM.
-
Konwertuj Markdown na HTML
Markdown jest konwertowany na HTML na potrzeby publikowania w Internecie. # Cześć staje się <h1>Witam</h1>, **pogrubienie** staje się <strong>pogrubieniem</strong>. Generatory witryn statycznych (Astro, Hugo, Jekyll) konwertują Markdown w czasie kompilacji. Skorzystaj z naszego konwertera Markdown na HTML, aby uzyskać natychmiastową konwersję.
Przykłady
Nagłówek i akapit
Wejście: # Tytuł
Akapit.
Wyjście: <h1>Title</h1>
<p>A paragraph.</p>
Pogrubienie i kursywa
Wejście: **pogrubienie** i *kursywa*
Wyjście: <strong>bold</strong> and <em>italic</em>
Link i obraz
Wejście: [text](https://example.com) and 
Wyjście: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Typowe problemy
- Podziały wierszy — pojedynczy znak nowej linii w Markdown nie powoduje podziału wiersza w HTML. Użyj dwóch spacji na końcu wiersza lub dwóch znaków nowej linii w celu podziału akapitu.
- Listy zagnieżdżone — wcięcia mają znaczenie. W przypadku zagnieżdżonych elementów konsekwentnie używaj 2 lub 4 spacji; zmieszanie ich może złamać strukturę listy.
- Surowy HTML — większość analizatorów Markdown przechodzi przez surowy HTML, ale niektóre go oczyszczają. Sprawdź zachowanie parsera, jeśli osadzisz bezpośrednio HTML.
- Różne smaki — Original Markdown, CommonMark i GFM mają subtelne różnice. Sprawdź, jaki smak obsługuje Twoja platforma docelowa.
Porady
- Do pisania i dokumentacji używaj języka Markdown — jest on znacznie łatwiejszy do czytania i pisania niż HTML.
- Najpopularniejszym wariantem jest GitHub Flavoured Markdown (GFM), który dodaje tabele, przekreślenia i listy zadań.
- Zapisuj w Markdown i konwertuj na HTML w czasie tworzenia blogów i witryn z dokumentacją.
- Skorzystaj z naszego konwertera Markdown na HTML, aby natychmiast renderować Markdown w przeglądarce.