Přeskočit obsah

Zásuvný modul Náhled Markdownu

Živý náhled aktivního dokumentu Markdown vedle něj, vykreslený v ukotvitelném panelu, který se aktualizuje při psaní. Vykreslovač je bez závislostí (používá vestavěné zobrazení formátovaného textu z Qt, nikoli prohlížečové jádro), takže je tento modul vždy dostupný a nepřidává žádné těžké závislosti.

Kde to najdete

Zobrazit ▸ Náhled Markdownu otevře (nebo zavře) dok s náhledem pro aktuální kartu. Dok dává přednost pravé straně a lze jej táhnout, nechat plavat nebo zařadit do karet jako kterýkoli jiný panel.

Jak se chová

  • Živé vykreslování. Náhled se překresluje při psaní, s prodlevou, aby psaní zůstalo svižné (u velmi velkých souborů se prodleva automaticky uvolní).
  • Sledování kurzoru. Se zapnutou volbou Sledovat kurzor (na liště) se náhled posune k bloku, který upravujete, kdykoli kurzor přejde na jiný řádek. Protože jej posouvá jen přesun kurzoru, hledání přenese náhled na nalezené místo a pak jej nechá být: můžete od nálezu odscrollovat a náhled zůstane tam, kam jste jej dali, dokud kurzorem znovu nepohnete. Vypnutím volby budete náhled posouvat úplně nezávisle. Nastavení se pamatuje.
  • Respektuje motiv. Barvy náhledu pocházejí z aktivního motivu editoru (text, bloky kódu, citace, odkazy), takže náhled odpovídá světlému i tmavému motivu a při změně motivu se živě aktualizuje. Tyto barvy si můžete doladit v Editoru motivů pod kategoriemi Markdown.
  • Export a otevření v prohlížeči. Lišta umí vyexportovat vykreslené HTML do souboru nebo je otevřít ve výchozím prohlížeči. V obou případech dostanete čistou, samostatnou stránku: jednoduché, sémantické značky bez lešení, které náhled potřebuje jen sám pro sebe, a pevný světlý styl, takže se sdílený soubor čte normálně bez ohledu na váš motiv editoru.
  • Velikost panelu. Náhled si drží podíl okna, ne pevnou šířku, takže roste a zmenšuje se s oknem — viz Uložené rozvržení.

Viditelnost náhledu

Viditelnost náhledu se pamatuje pro každý soubor zvlášť, jak během relace, tak napříč restarty:

  • Soubory Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) otevírají náhled automaticky, když si je poprvé zobrazíte. Tato výchozí volba »automatického otevírání« je trvalý přepínač v Zobrazit ▸ Automaticky otevírat náhled Markdownu.
  • Ostatní soubory ne — ale náhled můžete otevřít u libovolného souboru volbou Zobrazit ▸ Náhled Markdownu a onen soubor se vykreslí jako Markdown.
  • V rámci relace se to, co pro kartu zvolíte, obnoví, když se na ni vrátíte.
  • Napříč restarty se pamatuje vaše výslovná volba pro daný soubor: zavřete-li náhled u souboru, zůstane zavřený, až jej příště otevřete; otevřete-li náhled u souboru, který by se sám neotevřel, znovu se otevře. Soubory, kterých jste se výslovně nedotkli, se prostě pokaždé řídí výchozí volbou automatického otevírání — takže pozdější zapnutí automatického otevírání stále otevře náhledy, které jste záměrně nezavřeli.

Co vykresluje

  • Značky v řádku — *kurzivu*, **tučné**, ***tučnou kurzivu***, ~~přeškrtnuté~~, vložený kód a tvrdá zalomení řádků.
  • Nadpisy — jak ve formě #, tak v podtržené (setextové) formě.
  • Seznamy — číslované i nečíslované, vnořené, sevřené i volné (volný seznam dostane odstavcové mezery), začínající číslem, které jste napsali, a seznamy úkolů: - [ ] a - [x] se vykreslí jako ☐ a ☑.
  • Tabulky — tabulky se svislítky a zarovnáním po sloupcích (vlevo, na střed, vpravo). Krátký řádek se doplní, přebývající buňka se zahodí a široká tabulka se zalomí, místo aby se odřízla.
  • Kód — bloky ohraničené ploty i bloky odsazené, vykreslené v rámovaném, vyplněném rámečku neproporcionálním písmem, takže se blok odlišuje od textu a ASCII diagramy i zarovnané sloupce si udrží svou podobu.
  • Odkazy a obrázky — v řádku, odkazem na definici ([text][ref] s definicí kdekoli v souboru) a holé adresy http://, https:// nebo www., které se odkazy stanou samy. Cesty k obrázkům se vyhodnocují relativně k souboru.
  • Citace a vodorovné čáry.
  • YAML front matter — blok metadat --- … ---, který některé nástroje očekávají hned na začátku souboru, se zobrazí jako blok kódu yaml a není zaměněn za nadpis.

Syrové HTML se zobrazí jako text, záměrně: značky se escapují, místo aby se spouštěly, takže náhled dokumentu, který jste nenapsali vy, nemůže nic spustit. Bloky HTML a poznámky pod čarou se nevykreslují.

Které odkazy se otevírají

Kliknutí na odkaz v náhledu jej otevře jen tehdy, je-li cílem http, https nebo mailto; #fragment posune náhled na daný nadpis. Každý jiný cíl — cesta file:, obyčejná či relativní cesta, adresa javascript:, vlastní schéma nějaké aplikace — se ignoruje a stavový řádek řekne, který odkaz nebyl otevřen a proč. Důvodem je samotný dokument: markdownový soubor, který jste naklonovali nebo stáhli, je cizí text a jediné kliknutí v něm nesmí být schopné spustit program na vašem počítači.

Podržení ukazatele nad odkazem ukáže, kam vede, ještě než kliknete — a na druhém řádku i to, že jde o odkaz, který náhled neotevře.

Viz také

  • Náhled HTML — plnohodnotný náhled (CSS/JavaScript) pro HTML a PHP, využívající QtWebEngine.
  • Editor motivů — nastavení barev Markdown v náhledu.