Wtyczka Podgląd Markdown

Podgląd aktywnego dokumentu Markdown na żywo, obok tekstu, renderowany w dokowalnym panelu aktualizującym się podczas pisania. Renderer nie ma zależności (używa wbudowanego widoku tekstu sformatowanego Qt, nie silnika webowego), więc ta wtyczka jest zawsze dostępna i nie dodaje ciężkich zależności.

Gdzie to znaleźć

Widok ▸ Podgląd Markdown otwiera (lub zamyka) panel podglądu dla bieżącej karty. Panel preferuje prawą stronę i można go przeciągać, odrywać lub układać w karty jak każdy inny panel.

Jak się zachowuje

• Renderowanie na żywo. Podgląd renderuje się ponownie w trakcie pisania, z opóźnieniem (debounce), aby pisanie pozostało płynne (przy bardzo dużych plikach opóźnienie automatycznie się wydłuża).
• Podążanie za karetką. Przy włączonym Podążaj za kursorem (pasek narzędzi) podgląd przewija się tak, aby edytowany blok był widoczny. Wyłącz tę opcję, aby przewijać podgląd niezależnie. Ustawienie jest zapamiętywane.
• Zgodność z motywem. Kolory podglądu pochodzą z aktywnego motywu edytora (tekst, bloki kodu, cytaty, łącza), więc podgląd pasuje do jasnego lub ciemnego motywu i aktualizuje się na żywo przy zmianie motywu. Te kolory można doprecyzować w Edytorze motywów w kategoriach Markdown.
• Eksport / otwarcie w przeglądarce. Z paska narzędzi można wyeksportować wyrenderowany HTML do pliku albo otworzyć go w domyślnej przeglądarce. Wyeksportowany HTML używa stałego jasnego arkusza stylów, więc udostępniony plik czyta się normalnie niezależnie od motywu Twojego edytora.

Widoczność podglądu

Widoczność podglądu jest zapamiętywana per plik, zarówno w trakcie sesji, jak i między uruchomieniami:

• Pliki Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) otwierają podgląd automatycznie przy pierwszym wyświetleniu. To domyślne „automatyczne otwieranie” jest trwałym przełącznikiem w Widok ▸ Automatycznie otwieraj podgląd Markdown.
• Inne pliki nie — ale podgląd można otworzyć na dowolnym pliku przez Widok ▸ Podgląd Markdown, a plik zostanie wyrenderowany jako Markdown.
• W ramach sesji wybór dokonany dla karty jest przywracany po powrocie do niej.
• Między uruchomieniami zapamiętywany jest Twój jawny wybór dla pliku: zamknij podgląd na pliku, a pozostanie zamknięty przy następnym otwarciu tego pliku; otwórz podgląd na pliku, który nie otworzyłby się automatycznie, a otworzy się ponownie. Pliki, których nigdy jawnie nie dotknięto, po prostu za każdym razem podążają za domyślnym automatycznym otwieraniem — więc późniejsze włączenie tej opcji nadal otwiera podglądy, których nigdy celowo nie zamknięto.

Co renderuje

Nagłówki, pogrubienie / kursywę, code w tekście i bloki kodu w ogrodzeniach, listy numerowane i punktowane, cytaty blokowe, linie poziome, łącza, obrazy (rozwiązywane względem pliku), autolinki i twarde podziały wiersza. Tekst jest zabezpieczany (HTML-escape), a osadzony surowy HTML nie jest wykonywany, więc podgląd dokumentu nigdy nie uruchamia dowolnych znaczników.

Zobacz też

• Podgląd HTML — pełnowartościowy podgląd (CSS/JavaScript) dla HTML i PHP, oparty na QtWebEngine.
• Edytor motywów — dostosowanie kolorów Markdown w podglądzie.