Edytor Markdown

Ten edytor Markdown online pokazuje tekst po lewej stronie, a sformatowany wynik po prawej, i podgląd zmienia się z każdym naciśniętym klawiszem. Rozumie Markdown używany na GitHubie, w plikach README, wiki i aplikacjach do notatek, takich jak Obsidian: nagłówki, listy, listy zadań, tabele, kod, cytaty, linki, obrazy i przypisy. Nie potrzebujesz konta, a nic, co wpiszesz, nie jest nigdzie wysyłane.

Jak korzystać z edytora Markdown online

1. Wpisz lub wklej Markdown do lewego pola albo otwórz plik .md przyciskiem pliku na pasku narzędzi. Plik możesz też upuścić w dowolnym miejscu edytora.
2. Obserwuj podgląd po prawej stronie. Synchroniczne przewijanie utrzymuje obie strony w tym samym miejscu dokumentu, gdy przewijasz którąkolwiek z nich.
3. Formatuj tekst za pomocą paska narzędzi albo skrótów, takich jak Ctrl+B dla pogrubienia i Ctrl+K dla linku.
4. Skopiuj wynik jako Markdown, jako HTML albo jako tekst z formatowaniem lub pobierz go jako plik .md, .pdf, .docx, .html albo .txt.

Edytor otwiera się z krótkim przykładem „Notatki projektowe”, który zawiera wszystkie popularne elementy, więc zanim zaczniesz pisać własny tekst, zobaczysz składnię i jej wynik obok siebie.

Edytor Markdown z podglądem na żywo

Nad edytorem są do wyboru trzy widoki. Obok siebie pokazuje Markdown i podgląd w dwóch kolumnach, Edycja oddaje całą szerokość tekstowi, a Podgląd pokazuje tylko wynik, więc służy też jako prosta przeglądarka Markdown, gdy chcesz przeczytać plik, który ktoś Ci przysłał. Na telefonie edytor przełącza się między widokami Edycja a Podgląd, bo dwie kolumny byłyby zbyt wąskie, żeby wygodnie czytać.

Podgląd jest renderowany tak, jak Markdown renderuje GitHub: według CommonMark z rozszerzeniami GitHub Flavored Markdown (obie strony po angielsku), które dodają tabele, listy zadań, przekreślenie i automatyczne linki. Nagłówki dostają kotwice jak na GitHubie, więc do ## Plan wydania można odesłać linkiem #plan-wydania, a kliknięcie takiego linku przewija podgląd do nagłówka. Przypisy zapisane jako [^1] są numerowane w kolejności pierwszego odwołania i wypisane na końcu.

Pole tekstowe korzysta ze sprawdzania pisowni w Twojej przeglądarce, więc błędnie napisane słowa są podkreślane już w trakcie pisania. Pod edytorem widać liczbę słów i znaków oraz czas czytania. Liczniki pomijają składnię Markdown, więc nagłówek oznaczony ## liczy tylko swoje słowa. Aby policzyć także zdania i akapity, wklej tekst do licznika słów i znaków.

Pasek narzędzi i skróty klawiszowe

Pasek narzędzi obejmuje wszystko, czego potrzebuje typowy dokument: Nagłówek, Pogrubienie, Kursywa, Przekreślenie, Kod w tekście, Link, Obraz, Cytat, Blok kodu, Lista punktowana, Lista numerowana, Lista zadań, Tabela i Linia pozioma. Jeśli najpierw zaznaczysz tekst, przycisk otoczy go znacznikami, a ponowne naciśnięcie tego samego przycisku je usunie. Bez zaznaczenia przycisk wstawia krótki tekst zastępczy, który jest już zaznaczony, więc wystarczy wpisać w jego miejsce własny.

Kilka udogodnień, które oszczędzają czas:

• Nagłówek zmienia bieżący wiersz kolejno na #, ##, ### i z powrotem na zwykły tekst.
• Link zamienia zaznaczone słowa w [słowa](https://) i zaznacza część z adresem, gotową do wklejenia adresu URL. Jeśli zamiast tego zaznaczysz adres URL, stanie się on adresem linku.
• Przyciski list i Cytat działają na wszystkich zaznaczonych wierszach naraz. Kliknięcie Lista numerowana na liście punktowanej zamienia ją w listę numerowaną.
• Naciśnij Enter na końcu pozycji listy, a następna pozycja zacznie się od właściwego znacznika. Numery rosną, nowe zadanie zaczyna się niezaznaczone, a Enter w pustej pozycji kończy listę. Tab i Shift+Tab zwiększają i zmniejszają wcięcie pozycji listy.
• Każdą zmianę wprowadzoną przyciskiem lub skrótem można cofnąć za pomocą Ctrl+Z.

Wszystkie skróty są wymienione w sekcji Skróty klawiszowe pod edytorem. Na Macu zamiast Ctrl używają klawisza Command.

Wklejanie z Worda lub Google Docs jako Markdown

Gdy wklejasz tekst skopiowany z Worda, Google Docs lub strony internetowej, edytor zamienia jego formatowanie na Markdown, zamiast je odrzucać. Nagłówki stają się wierszami z #, pogrubiony tekst i kursywa dostają swoje gwiazdki, linki zachowują adresy, listy punktowane i numerowane (także wielopoziomowe listy z Worda) stają się listami Markdown, a tabele zamieniają się w tabele Markdown z pierwszym wierszem jako nagłówkiem. To najszybszy sposób, aby przenieść istniejący dokument do pliku README albo na stronę wiki.

Jeśli zależało Ci na samym tekście, kliknij Użyj zwykłego tekstu w komunikacie, który pojawi się po wklejeniu, albo wklej za pomocą Ctrl+Shift+V. Kod skopiowany z VS Code lub innego edytora kodu oraz tekst, który już jest w Markdown, są wklejane dokładnie w takiej postaci, w jakiej są.

Ściągawka ze składni Markdown

Najczęściej używana składnia w jednym miejscu. Wpisz do edytora to, co jest w lewej kolumnie, a w podglądzie zobaczysz to, co w prawej.

Wpisujesz	Otrzymujesz
# Tytuł, ## Sekcja, ### Podsekcja	nagłówki od poziomu 1 do 3 (do 6 z ######)
**pogrubienie** i *kursywa*	pogrubienie i kursywa
~~stare~~	stare
`kod`	kod czcionką o stałej szerokości znaków
[tekst](https://example.com)	link
	obraz
- pozycja lub 1. pozycja	lista punktowana lub numerowana
- [ ] zadanie i - [x] gotowe	lista zadań z polami wyboru
> cytowany tekst	cytat
trzy grawisy (backticki) w wierszu przed kodem i po nim	blok kodu
--- w osobnym wierszu	linia pozioma
tekst[^1] i [^1]: uwaga	przypis

Tabela Markdown potrzebuje wiersza nagłówka, wiersza separatora z kresek, a potem po jednym wierszu tekstu na każdy wiersz tabeli, z komórkami oddzielonymi znakiem |. Dwukropek w separatorze ustawia wyrównanie: :-- wyrównuje do lewej, :-: wyśrodkowuje, a --: wyrównuje do prawej. Przycisk Tabela wstawia gotową tabelę z trzema kolumnami, od której możesz zacząć. Komórki w źródle nie muszą być wyrównane, ale wyrównane łatwiej później edytować.

Markdown przyjmuje też HTML dla elementów, dla których nie ma własnej składni, na przykład <kbd>Ctrl</kbd> dla klawiszy, <sub> i <sup> dla H₂O i x² albo <details> dla sekcji, która rozwija się po kliknięciu. Skrypty, style i formularze są ze względów bezpieczeństwa usuwane z podglądu.

Kopiowanie z formatowaniem i pobieranie pliku

Kopiuj Markdown kopiuje źródło, Kopiuj HTML kopiuje czysty HTML gotowy do umieszczenia na stronie internetowej lub w systemie CMS, a Kopiuj z formatowaniem kopiuje sformatowany wynik. Wklej go do Google Docs, Worda, Outlooka lub Gmaila, a nagłówki, pogrubiony tekst, listy, linki i tabele trafią tam sformatowane, bez żadnych symboli Markdown.

Przyciski Pobierz jednym kliknięciem zapisują dokument jako Markdown, PDF, Word, HTML lub zwykły tekst, z nazwą wziętą z tytułu w front matter albo z pierwszego nagłówka. Używają rozsądnych ustawień domyślnych: papier A4 (Letter w USA, Kanadzie, Meksyku i innych krajach, w których jest standardem), normalne marginesy i tekst o wielkości 11 pt. Aby wybrać rozmiar strony, czcionki i marginesy, dodać spis treści albo przekonwertować kilka plików naraz, kliknij Więcej opcji eksportu, co otworzy konwerter Markdown z wpisanym już tekstem.

Często zadawane pytania

Czy mój tekst jest gdzieś wysyłany lub zapisywany?

Nie. Podgląd, konwersja i pobieranie odbywają się w Twojej przeglądarce, a tekst nigdy nie trafia na serwer. Domyślnie nic nie jest też zapisywane, więc po zamknięciu karty tekst znika. Jeśli zaznaczysz Zapamiętaj szkic w tej przeglądarce, tekst jest po każdej zmianie zapisywany w pamięci Twojej własnej przeglądarki i wraca przy następnej wizycie. Na wspólnym komputerze odznacz tę opcję, co usunie też zapisany szkic.

Jak otworzyć plik .md i wyświetlić go online?

Kliknij przycisk pliku na pasku narzędzi albo upuść plik na edytor, a potem przełącz się na Podgląd, żeby czytać go jako sformatowany dokument. Pliki do 20 MB w kodowaniu UTF-8 lub UTF-16 otwierają się bezpośrednio. Obrazy z pliku są wyświetlane, jeśli mają pełny adres internetowy; obrazów zapisanych obok pliku na Twoim komputerze strona internetowa nie może wczytać.

Jakiej odmiany Markdown używa edytor?

Stosuje CommonMark (po angielsku), standard uznawany przez większość narzędzi Markdown, oraz rozszerzenia GitHuba: tabele, listy zadań, przekreślenie, automatyczne linki i przypisy. Tekst napisany dla GitHuba, GitLaba, Obsidiana, Reddita czy Discorda wygląda tutaj tak samo, poza funkcjami, które te serwisy dodają od siebie, takimi jak wzmianki o użytkownikach czy linki wiki w Obsidianie.

Jak przenieść Markdown do Google Docs?

Kliknij Kopiuj z formatowaniem i wklej tekst do dokumentu. Nagłówki, listy, linki i tabele zachowają formatowanie. Nowsze wersje Google Docs potrafią też same odczytać Markdown: gdy włączysz obsługę Markdown w ustawieniach w menu Narzędzia, w menu Edytuj pojawi się polecenie wklejania z Markdown.

Czy edytor obsługuje diagramy Mermaid lub wzory matematyczne w LaTeX?

Jeszcze nie. Blok Mermaid jest wyświetlany jako zwykły blok kodu, a wzory zapisane jako $...$ pozostają zwykłym tekstem. Cała reszta GitHub Flavored Markdown jest obsługiwana.

Co to jest Markdown i kto go używa?

Markdown to sposób formatowania zwykłego tekstu za pomocą kilku symboli, który John Gruber stworzył w 2004 roku po to, żeby dokument był czytelny jeszcze przed konwersją do HTML (więcej w Wikipedii). Programiści używają go w plikach README i dokumentacji, autorzy w notatkach i szkicach, a czaty AI odpowiadają w nim, dlatego ich odpowiedzi wklejone w inne miejsce są pełne gwiazdek i krzyżyków.

Więcej narzędzi do pracy z tekstem znajdziesz w kategorii Tekst: porównaj dwie wersje dokumentu, żeby zobaczyć, co się zmieniło, albo za jednym razem zmień wielkość liter w nagłówkach. Programiści znajdą JSON Formatter i inne narzędzia w kategorii Programiści.