Edytor Markdown

Czym jest edytor Markdown?

Edytor Markdown to narzędzie, które pozwala edytować tekst napisany w składni Markdown, jednocześnie wyświetlając podgląd tego, jak będzie on faktycznie wyglądał. Markdown wykorzystuje proste symbole, takie jak „#” dla nagłówków, „-” dla list punktowanych oraz „**” dla tekstu pogrubionego.Jest to łatwiejsze w odczycie i pisaniu niż bezpośrednie wpisywanie tagów HTML i znajduje zastosowanie w wielu różnych kontekstach, w tym w plikach README, dokumentach technicznych, wpisach na blogach, notatkach, specyfikacjach i wiadomościach na czacie.

To narzędzie zapewnia podgląd wprowadzanych treści w czasie rzeczywistym. Możesz stosować formatowanie, takie jak pogrubienie, kursywa, nagłówki, cytaty, kod, linki, obrazy, listy i tabele bezpośrednio z paska narzędzi, dzięki czemu nie musisz zapamiętywać całej składni Markdown. Oprócz skopiowania wprowadzonego kodu Markdown można skopiować przekonwertowany kod HTML lub zapisać go jako plik .md lub HTML.

Obsługiwana składnia różni się w zależności od dialektu Markdown i używanej usługi. Oprócz powszechnie stosowanej składni narzędzie to zapewnia uproszczoną obsługę przekreśleń, list kontrolnych, bloków kodu i tabel. Podczas wklejania treści do serwisu GitHub, serwisów blogowych, systemów CMS lub innych platform należy sprawdzić ostateczny wygląd treści w witrynie docelowej.

Wprowadzony tekst nie jest wysyłany na serwer; jest on przetwarzany za pomocą JavaScript w przeglądarce. Chociaż takie rozwiązanie ułatwia tworzenie wersji roboczych przed publikacją lub dokumentów wewnętrznych, treść może pozostać w historii przeglądarki lub schowku na urządzeniach współużytkowanych. Należy przestrzegać zasad obowiązujących w danym środowisku pracy dotyczących postępowania z informacjami poufnymi.

Najważniejsze funkcje

• Podgląd aktualizuje się na bieżąco podczas wpisywania.
• Można wyświetlać nagłówki, elementy wyróżnione, cytaty, listy, kod, linki, obrazy i tabele.
• Za pomocą paska narzędzi można łatwo wstawiać składnię Markdown.
• Można skopiować zarówno kod Markdown, jak i wynikowy kod HTML.
• Można zapisywać pliki .md i HTML.
• Można sprawdzić liczbę znaków, liczbę słów i liczbę wierszy.
• Dane wprowadzane są przetwarzane w przeglądarce.

Sposób użycia

1. Wpisz kod Markdown w polu po lewej stronie.
2. W razie potrzeby zastosuj formatowanie z paska narzędzi.
3. Sprawdź wyświetlanie w podglądzie w czasie rzeczywistym po prawej stronie.
4. Jeśli chcesz wyświetlić tę treść w osobnym oknie, aby ułatwić sobie czytanie, kliknij „Wyświetl w osobnym oknie”.
5. W razie potrzeby skopiuj i zapisz kod Markdown lub HTML.

Środki ostrożności dotyczące użytkowania

• Zakres obsługi Markdown oraz metody wyświetlania różnią się w zależności od serwisu.
• Ze względów bezpieczeństwa podgląd traktuje wprowadzone tagi HTML jako zwykły tekst, zamiast je wykonywać.
• Obrazy zewnętrzne są wyświetlane poprzez dostęp do źródła adresu URL obrazu.
• W przypadku bardzo długich zdań aktualizacja podglądu może zająć trochę czasu, w zależności od wydajności urządzenia.
• Korzystając z przekonwertowanego kodu HTML, należy sprawdzić, czy jest on zgodny z wymogami bezpieczeństwa witryny docelowej.

Najczęściej zadawane pytania

Czym jest Markdown?

Lekki język znaczników, który wykorzystuje symbole do oznaczania nagłówków, elementów wyróżnionych, list, linków i innych elementów. Charakteryzuje się zdolnością do zachowania czytelności oryginalnego tekstu.

Czy tekst, który wpiszę, zostanie wysłany na serwer?

Nie. Konwersja z Markdown do HTML oraz podgląd odbywają się w przeglądarce.

Czy mogę wprowadzać tagi HTML bezpośrednio?

Można wprowadzić tekst, ale ze względów bezpieczeństwa zostanie on wyświetlony jako zwykły tekst, a nie jako kod HTML. Proszę używać składni Markdown.

Czy jest w pełni zgodny z GitHub Flavored Markdown?

Oprócz standardowego Markdownu zapewniamy podstawową obsługę kluczowych elementów formatowania, takich jak tabele, listy kontrolne i przekreślenia; nie odzwierciedla to jednak w pełni wszystkich specyfikacji własnych serwisu GitHub.

Czy bloki kodu będą oznaczone kolorami?

Fragmenty kodu, w których podano nazwę języka, są wyświetlane z atrybutem `class`, ale ponieważ na tej stronie nie jest używana biblioteka podświetlania składni, automatyczne kodowanie kolorami nie jest wykonywane.

Czy możesz przekonwertować Markdown na HTML?

Tak. Kod HTML używany do podglądu można uzyskać, klikając „Kopiuj HTML” lub „Zapisz HTML”.

Czy mogę zapisywać pliki w formacie Markdown?

Tak. Kliknięcie przycisku „Zapisz .md” spowoduje zapisanie wprowadzonych danych jako pliku Markdown w formacie UTF-8.

Jak utworzyć tabelę?

W pierwszej linii należy wpisać nagłówek, w drugiej – pozycje oddzielone myślnikami, a od trzeciej linii – dane oddzielone pionowymi liniami. Szablon można wstawić za pomocą przycisku tabeli na pasku narzędzi.

Dlaczego w podglądzie nie wyświetlają się znaki końca linii?

W formacie Markdown pojedynczy znak końca linii jest traktowany jako pojedynczy akapit. Aby utworzyć nowy akapit, należy wstawić pustą linię; aby wymusić znak końca linii, należy wstawić dwie spacje o połowie szerokości na końcu linii.

Czy mogę osadzić obraz?

Tak. Można podać publiczny adres URL obrazu. Nie przesyłamy jednak plików lokalnych ani nie zapisujemy ich na serwerze.

Czy aplikacja jest dostępna na smartfonach?

Tak. Na wąskich ekranach pole wprowadzania danych i podgląd są rozmieszczone pionowo, dzięki czemu można edytować treść nawet na smartfonie.

Czy mogę opublikować skopiowany kod HTML w obecnej postaci?

Można to wykorzystać jako podstawowy kod HTML, ale przed opublikowaniem należy to sprawdzić, ponieważ wygląd może się różnić w zależności od arkusza stylów CSS i ustawień bezpieczeństwa działającej witryny.