tigtools

Podgląd Markdown

Wpisz lub wklej Markdown po lewej stronie i zobacz obok wyrenderowany podgląd. Podgląd działa w izolowanym środowisku, więc skrypty w tekście nigdy się nie uruchomią.

Działa w przeglądarce Bez rejestracji

Pokaż

Jak używać

  1. Wpisz Markdown w edytorze lub kliknij „Wypróbuj przykład”, aby wczytać dokument z tabelami i listą zadań.
  2. Obserwuj, jak podgląd aktualizuje się podczas pisania. Przełącz na „Źródło HTML”, aby zobaczyć wygenerowane znaczniki.
  3. Włącz lub wyłącz GitHub Flavored Markdown albo obsługę pojedynczych znaków nowego wiersza, aby dopasować tekst do miejsca publikacji.
  4. Skopiuj kod HTML do systemu CMS lub wiadomości e-mail albo pobierz wynik jako plik .html lub .md.

Jak to działa

Markdown jest konwertowany za pomocą marked — popularnego parsera open source zgodnego ze specyfikacją CommonMark, a po włączeniu opcji GFM także z GitHub Flavored Markdown: obsługuje tabele z kolumnami wyrównanymi za pomocą znaków potoku, listy zadań, ~~przekreślenie~~ i automatyczne linki dla zwykłych adresów URL. Przypisy, zapis matematyczny i diagramy Mermaid nie należą do tych specyfikacji i są wyświetlane jako zwykły tekst.

Markdown może zawierać surowy HTML, który — tak jak w większości rendererów Markdown — jest przekazywany bez zmian. Aby zapewnić bezpieczeństwo, podgląd nigdy nie jest wstawiany bezpośrednio na tę stronę. Jest wyświetlany w izolowanej ramce, która nie może uruchamiać skryptów, wysyłać formularzy, otwierać wyskakujących okien ani uzyskiwać dostępu do tej witryny. Zasady bezpieczeństwa treści ramki blokują skrypty, zewnętrzne arkusze stylów, czcionki i ramki. Tag <script> lub atrybut onclick w kodzie Markdown jest widoczny w źródle HTML, ale nigdy nie zostaje uruchomiony. Linki w podglądzie są widoczne, ale nie można ich otworzyć — jeśli chcesz przejść pod dany adres, skopiuj URL.

Podgląd korzysta z neutralnego arkusza stylów, podobnego do tych używanych przez popularne renderery plików README. Twoja witryna lub GitHub może inaczej stylizować ten sam kod HTML. Kopiowany kod HTML to fragment bez stylów; pobrany plik .html zawiera podstawowy arkusz stylów, dzięki czemu wygląda jak podgląd. Pobrany lub skopiowany kod HTML nie jest oczyszczany, więc zawarte w nim skrypty zostaną uruchomione w miejscu, do którego go wkleisz, lub po jego otwarciu.

Przykłady

Sprawdzanie pliku README przed wysłaniem

Wklej plik README.md, aby sprawdzić, czy kolumny tabeli są równo ustawione, lista zadań wyświetla się jako pola wyboru, a bloki kodu są poprawnie oznaczone — zanim prześlesz plik do GitHub.

Tworzenie treści dla systemu CMS obsługującego HTML

Napisz szkic wpisu na bloga w Markdown, a następnie kliknij „Kopiuj HTML” i wklej znaczniki <h2>, <p> i <ul> do edytora HTML w systemie CMS.

Podział na wiersze jak w komunikatorze

Tekst z komunikatora zawiera wiersze rozdzielone pojedynczymi znakami nowego wiersza. Włączenie opcji „Traktuj pojedyncze znaki nowego wiersza jako <br>” zachowuje podział na wiersze zamiast łączyć je w jeden akapit.

Często zadawane pytania

Czy wklejanie Markdown z nieznanego źródła jest bezpieczne?

Tak, jeśli chodzi o podgląd. Wyrenderowany kod HTML jest wyświetlany w izolowanej ramce z wyłączonymi skryptami, więc nawet tag <script> lub procedura obsługi zdarzeń w tekście nic tu nie zrobi. Zachowaj ostrożność przy wklejaniu wyeksportowanego kodu HTML — nie jest on oczyszczany.

Dlaczego moje obrazy się nie wyświetlają?

Obrazy z innych witryn są domyślnie blokowane, aby podgląd nie wysyłał żadnych żądań sieciowych. Włącz opcję „Wczytuj obrazy z innych witryn”, aby je wyświetlić. Ścieżki względne, takie jak ./docs/screenshot.png, nie zadziałają, ponieważ tych plików tutaj nie ma.

Czy obsługuje przypisy, zapis matematyczny lub diagramy?

Nie. Obsługuje CommonMark i GitHub Flavored Markdown (tabele, listy zadań, przekreślenie i automatyczne linki). Przypisy, zapis matematyczny LaTeX i diagramy Mermaid to rozszerzenia, które w tym podglądzie są wyświetlane jako zwykły tekst.

Dlaczego pojedynczy znak nowego wiersza nie rozpoczyna nowego wiersza?

W standardowym Markdown pojedynczy znak nowego wiersza wewnątrz akapitu jest traktowany jak spacja. Zakończ wiersz dwiema spacjami, zostaw pusty wiersz lub włącz opcję „Traktuj pojedyncze znaki nowego wiersza jako <br>”.

Prywatność

Markdown jest konwertowany w Twojej przeglądarce — nie jest przesyłany ani zapisywany. Podgląd nie pobiera niczego z internetu, chyba że zezwolisz na wyświetlanie obrazów z innych witryn. W takim przypadku obrazy są pobierane bezpośrednio z ich serwerów.