Edytor Markdown
Działa na Twoim urządzeniu. Nic nie jest wysyłane.Wszystko odbywa się na Twoim własnym urządzeniu. Nic, co wpiszesz, nie jest nigdzie wysyłane.
Markdown
Podgląd
Twój wyrenderowany podgląd pojawi się tutaj
Pisz w Markdown z podglądem na żywo, a następnie eksportuj czysty HTML lub surowy plik Markdown, całkowicie w przeglądarce.
Ten edytor konwertuje Markdown na HTML na żywo podczas pisania, całkowicie w Twojej przeglądarce, i obsługuje składnię, po którą ludzie faktycznie sięgają na co dzień: nagłówki, pogrubiony i pochylony tekst, linki, obrazy, listy, cytaty, kod wstawiony w tekście i bloki kodu. Wszystko, co wpiszesz, jest przekształcane w bezpieczny HTML (escaping) zanim zostanie zastosowane jakiekolwiek formatowanie, więc wklejony HTML lub tagi script wyświetlają się jako zwykły widoczny tekst zamiast być wykonywane - nic, co napiszesz, nie jest nigdy nigdzie przesyłane.
Najczęściej zadawane pytania
Czy to pełna specyfikacja CommonMark?
Nie - obejmuje to najczęściej używaną składnię (nagłówki, wyróżnienia, linki, obrazy, listy, cytaty, kod), a nie pełną specyfikację CommonMark ze wszystkimi jej przypadkami brzegowymi, jak zagnieżdżone listy, tabele czy przypisy. W przypadku codziennych notatek, plików README i dokumentacji ten podstawowy podzbiór obejmuje zdecydowaną większość rzeczywistego Markdown.
Czy bezpiecznie jest wklejać Markdown ze źródła, któremu nie do końca ufam?
Tak. Każdy znak, który wpiszesz lub wkleisz, jest przekształcany w bezpieczny HTML zanim zostanie zastosowane jakiekolwiek formatowanie Markdown, a adresy URL linków lub obrazów są sprawdzane pod kątem listy dozwolonych, bezpiecznych schematów (http, https, mailto i ścieżki względne) przed użyciem - wklejony link javascript: lub osadzony tag <script> wyświetla się jako nieszkodliwy, widoczny tekst zamiast zostać wykonany.
Jaka jest różnica między pobraniem HTML a Markdown?
Pobranie Markdown zapisuje dokładnie to, co napisałeś, jako plik .md, do dalszej edycji później lub commitowania do repozytorium. Pobranie HTML zapisuje wyrenderowany wynik jako samodzielny plik .html, gotowy do wklejenia w CMS-ie, e-mailu lub gdziekolwiek indziej, gdzie oczekiwany jest gotowy HTML zamiast źródła Markdown.
Dlaczego moje podziały wierszy zniknęły w podglądzie?
Parser stosuje standardowe zasady akapitów Markdown: wiersze, które nie są oddzielone pustym wierszem, są łączone w jeden akapit, a każdy podział wiersza jest zamieniany na pojedynczą spację. Jeśli chcesz nowy akapit, zostaw pusty wiersz między blokami tekstu - jednokrotne naciśnięcie Enter nie utworzy widocznego podziału w wyrenderowanym wyniku.
Czy blok kodu obsługuje podświetlanie składni dla języka takiego jak ```js?
Jeszcze nie - język, który wpisujesz po otwierających potrójnych apostrofach odwrotnych, służy tylko do oznaczenia, gdzie zaczyna się blok, i jest odrzucany, nie jest wyświetlany ani kolorowany. Wszystko wewnątrz ogrodzenia jest escapowane i renderowane jako zwykły tekst o stałej szerokości, więc Twój kod pozostaje dokładnie taki, jak go wpisałeś, tylko bez kolorowania składni.
Czy obsługuje tabele?
Jeszcze nie - ten parser skupia się na składni, po którą ludzie sięgają najczęściej, a tabele rozdzielane pionowymi kreskami nie należą do tego zbioru. Tabela napisana w składni Markdown zostanie wyrenderowana jako zwykły tekst akapitu zamiast prawdziwej tabeli, więc na razie tabele trzeba pisać bezpośrednio w HTML, jeśli są potrzebne w wyeksportowanym wyniku.
Czy zagnieżdżone listy są obsługiwane?
Nie - każdy element listy jest traktowany jako płaski, niezależnie od wcięcia, więc wcięcie linii w celu utworzenia podlisty nie utworzy zagnieżdżonej listy; zamiast tego zostanie wyrenderowane jako kolejny element najwyższego poziomu. Jeśli potrzebujesz hierarchii, najbliższym obejściem jest zapisanie jej za pomocą nagłówków lub ręcznego wcięcia wewnątrz bloku kodu.
Czy ma znaczenie, czy użyję * czy _ do pogrubienia i kursywy?
Nie - oba są traktowane tak samo. **pogrubienie** i __pogrubienie__ dają pogrubiony tekst, a *kursywa* i _kursywa_ dają tekst pochylony. Przyciski B i I na pasku narzędzi zawsze wstawiają formę z gwiazdką, ale wpisanie formy z podkreśleniem działa dokładnie tak samo.
Czy mogę przekreślić tekst za pomocą ~~tak~~?
Obecnie nie - przekreślenie nie jest częścią składni rozpoznawanej przez ten parser, więc ~~tekst~~ jest wyświetlany dosłownie jako tyldy wokół zwykłego tekstu, a nie jako tekst przekreślony. To jedno z bardziej powszechnych rozszerzeń poza podstawowym Markdown, którego to narzędzie jeszcze nie obsługuje.
Jakie są różne sposoby zapisania linii poziomej?
Trzy lub więcej myślników, gwiazdek lub podkreśleń w osobnej linii - ---, *** lub ___ - wszystkie są renderowane jako linia pozioma. Przycisk ― na pasku narzędzi zawsze wstawia formę z myślnikiem, ale wszystkie trzy działają tak samo, jeśli wpiszesz je samodzielnie.
Czy cytat może obejmować wiele akapitów?
Każdy blok kolejnych linii > jest renderowany jako pojedynczy akapit wewnątrz cytatu, przy czym podziały wierszy są zamieniane na spacje, tak jak w zwykłych akapitach. Pozostawienie pustej linii cytatu, aby rozpocząć drugi akapit w tym samym cytacie, nie jest obsługiwane - zamiast tego kończy cytat.
Czy mogę wkleić sformatowany tekst z Worda lub Dokumentów Google?
Możesz wkleić do edytora, ale tylko jako zwykły tekst - przeglądarki usuwają bogate formatowanie (pogrubienie, nagłówki, linki) podczas wklejania do pola zwykłego tekstu, więc słowa zostają zachowane, ale formatowanie nie zamienia się automatycznie w składnię Markdown. Będziesz musiał ponownie zastosować nagłówki, pogrubienie i linki samodzielnie - dokładnie do tego służą przyciski paska narzędzi nad edytorem.
Co robią przyciski nad edytorem?
Każdy z nich wstawia odpowiednią składnię Markdown w miejscu kursora lub otacza nią zaznaczony tekst - kliknij B z zaznaczonym słowem, a stanie się ono **słowem**, kliknij H2 w pustej linii, a stanie się nagłówkiem. Są skrótem do dokładnej składni rozumianej przez ten parser, a nie osobnym systemem formatowania.
Czy istnieje limit ilości tekstu, który mogę wkleić?
Nie ma sztywno zakodowanego limitu, ale cały dokument jest ponownie analizowany od zera przy każdym naciśnięciu klawisza, całkowicie w głównym wątku Twojej przeglądarki. Jest to natychmiastowe w przypadku notatek i artykułów, ale bardzo duży dokument (dziesiątki tysięcy linii) może zacząć wydawać się ociężały podczas pisania, ponieważ nie ma analizy przyrostowej ani w tle.
Czy to działa tak samo w przypadku języków pisanych od prawej do lewej, takich jak arabski czy perski?
Tak - układ strony przełącza się dla tych języków na od prawej do lewej, a wyrenderowany podgląd podąża w tym samym kierunku, dzięki czemu nagłówki, listy i akapity czyta się naturalnie. Sama składnia Markdown (#, *, > itd.) pozostaje dokładnie taka sama, niezależnie od języka.
Dla programistów: otwórz tę stronę z parametrem `q` w adresie URL - np. gizke.com/markdown?q=# Hello world - a ta wartość zostanie automatycznie uzupełniona z góry. Większość odwiedzających tego nie potrzebuje; jest to przeznaczone do bezpośredniego linkowania do gotowego przykładu.