Czym jest Markdown?

Markdown to lekki język znaczników stworzony przez Johna Grubera w 2004 roku, pozwalający pisać sformatowany tekst przy użyciu składni zwykłego tekstu. Był zaprojektowany tak, aby był czytelny nawet w surowej postaci — gwiazdki dla podkreślenia, kratki dla nagłówków, myślniki dla list. Markdown jest szeroko stosowany w dokumentacji (pliki README na GitHub), aplikacjach do notatek (Obsidian, Notion), platformach blogowych i komunikacji deweloperów.

Narzędzie oferuje podgląd na żywo Twojego Markdownu podczas pisania. Lewy panel pokazuje surowe źródło Markdown, a prawy renderuje sformatowany wynik w czasie rzeczywistym. Obsługuje standardowy Markdown, rozszerzenia GitHub-Flavored Markdown (GFM) (tabele, listy zadań, przekreślenia, ogrodzenia kodu) oraz podświetlanie składni dla bloków kodu.

Podstawowa składnia Markdown

• Nagłówki: używaj # dla H1, ## dla H2, ### dla H3 i tak dalej do ###### dla H6.
• Pogrubienie: otocz tekst podwójnymi gwiazdkami lub podwójnymi podkreślnikami. Kursywa: użyj pojedynczych gwiazdek lub podkreślników.
• Listy: zacznij linie od - lub * dla punktów, albo 1. dla list numerowanych. Wcięciem twórz zagnieżdżenia.
• Linki: [tekst linku](URL). Obrazy: .
• Kod: użyj backticków dla kodu inline, potrójnych backticków dla ogrodzonych bloków kodu z opcjonalnym językiem dla podświetlania składni.

Jak korzystać z tego narzędzia

Wpisz lub wklej Markdown w edytorze. Podgląd aktualizuje się w czasie rzeczywistym. Możesz przełączać się między widokiem obok siebie a podglądem. Narzędzie obsługuje kopiowanie do schowka (zarówno źródła Markdown, jak i wyrenderowanego HTML), pobieranie jako plik .md i eksport jako HTML.

GitHub Flavored Markdown

GitHub Flavored Markdown rozszerza standardowy Markdown o tabele (kolumny oddzielone pionową kreską), listy zadań (pola wyboru z - [ ] i - [x]), tekst przekreślony (owinięty podwójnymi tyldami), automatycznie linkowane URL-e i ogrodzenia kodu z podświetlaniem składni. Narzędzie obsługuje wszystkie funkcje GFM, co czyni je idealnym do podglądu plików README i dokumentacji przed wypchnięciem na GitHub.

Najczęściej zadawane pytania

Czy można używać HTML wewnątrz Markdownu?

Tak. Standardowy Markdown pozwala na wbudowany HTML dla wszystkiego, czego nie można wyrazić składnią Markdown (np. złożone tabele, kolorowy tekst czy osadzone filmy). Jednak niektóre rendery Markdown (np. GitHub) usuwają pewne tagi HTML ze względów bezpieczeństwa. Narzędzie do podglądu renderuje większość tagów HTML, pokazując oczekiwany wynik.

Jaka jest różnica między Markdown a tekstem sformatowanym?

Tekst sformatowany (jak dokumenty Word) przechowuje formatowanie jako ukryte kody w pliku. Markdown przechowuje formatowanie jako widoczne znaki — **pogrubienie** jest dosłownie wpisane gwiazdkami. To sprawia, że pliki Markdown są przenośne (każdy edytor tekstu może je odczytać), przyjazne dla kontroli wersji (różnice są czyste) i trwałe (brak zastrzeżonego formatu).