Zásuvný modul Náhľad Markdownu

Živý náhľad aktívneho dokumentu Markdown vedľa textu, vykreslený v ukotviteľnom paneli, ktorý sa obnovuje počas písania. Vykresľovač nemá žiadne závislosti (používa vstavané zobrazenie formátovaného textu z Qt, nie prehliadačové jadro), takže je tento zásuvný modul vždy dostupný a nepridáva žiadne ťažké závislosti.

Kde ho nájdete

Zobraziť ▸ Náhľad Markdownu otvorí (alebo zatvorí) panel náhľadu pre aktuálnu kartu. Panel uprednostňuje pravú stranu a dá sa ťahať, nechať plávať alebo zaradiť do kariet ako ktorýkoľvek iný panel.

Ako sa správa

• Živé vykresľovanie. Náhľad sa počas písania prekresľuje, s oneskorením, aby písanie ostalo svižné (pri veľmi veľkých súboroch sa oneskorenie automaticky predlžuje).
• Sledovanie kurzora. So zapnutou voľbou Sledovať kurzor (panel nástrojov) sa náhľad posunie k bloku, ktorý upravujete, kedykoľvek kurzor prejde na iný riadok. Keďže ho posúva len presun kurzora, hľadanie prenesie náhľad na nájdené miesto a potom ho nechá na pokoji: od nálezu môžete odrolovať a náhľad ostane tam, kam ste ho dali, kým kurzorom znova nepohnete. Vypnutím voľby budete náhľad posúvať úplne nezávisle. Nastavenie sa pamätá.
• Rešpektuje motív. Farby náhľadu pochádzajú z aktívneho motívu editora (text, bloky kódu, citácie, odkazy), takže náhľad zodpovedá svetlému či tmavému motívu a pri zmene motívu sa aktualizuje naživo. Tieto farby si môžete doladiť v Editore motívov v kategóriách Markdown.
• Export a otvorenie v prehliadači. Panel nástrojov dokáže vykreslené HTML exportovať do súboru alebo ho otvoriť vo vašom predvolenom prehliadači. V oboch prípadoch dostanete čistú, samostatnú stránku: jednoduché, sémantické značky bez lešenia, ktoré náhľad potrebuje len sám pre seba, a pevný svetlý štýl, takže sa zdieľaný súbor číta bežne bez ohľadu na motív vášho editora.
• Veľkosť panela. Náhľad si drží podiel okna, nie pevnú šírku, takže rastie a zmenšuje sa spolu s oknom — pozri Uložené rozloženie.

Viditeľnosť náhľadu

Viditeľnosť náhľadu sa pamätá pre každý súbor zvlášť, počas relácie aj naprieč reštartmi:

• Súbory Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) otvárajú náhľad automaticky pri prvom zobrazení. Toto predvolené „automatické otváranie“ je trvalý prepínač v Zobraziť ▸ Automaticky otvárať náhľad Markdownu.
• Ostatné súbory nie — náhľad si však môžete otvoriť pri ktoromkoľvek súbore cez Zobraziť ▸ Náhľad Markdownu a daný súbor sa vykreslí ako Markdown.
• V rámci relácie sa vaša voľba pre kartu obnoví, keď sa na ňu vrátite.
• Naprieč reštartmi sa pamätá vaša výslovná voľba pre daný súbor: keď náhľad pri súbore zatvoríte, ostane zatvorený aj pri ďalšom otvorení tohto súboru; keď náhľad otvoríte pri súbore, kde by sa sám neotvoril, znova sa otvorí. Súbory, ktorých ste sa výslovne nikdy nedotkli, sa zakaždým jednoducho riadia predvoleným automatickým otváraním — takže neskorším zapnutím automatického otvárania sa náhľady, ktoré ste zámerne nezatvorili, znova otvoria.

Čo vykresľuje

• Značky v riadku — *kurzívu*, **tučné**, ***tučnú kurzívu***, ~~prečiarknuté~~, vnorený kód a tvrdé zalomenia riadkov.
• Nadpisy — vo forme # aj v podčiarknutej (setextovej) forme.
• Zoznamy — číslované aj nečíslované, vnorené, zhustené aj voľné (voľný zoznam dostane odstavcové medzery), začínajúce číslom, ktoré ste napísali, a zoznamy úloh: - [ ] a - [x] sa vykreslia ako ☐ a ☑.
• Tabuľky — tabuľky so zvislými čiarami a zarovnaním po stĺpcoch (vľavo, na stred, vpravo). Krátky riadok sa doplní, prebytočná bunka sa zahodí a široká tabuľka sa zalomí, namiesto toho, aby sa odrezala.
• Kód — bloky ohraničené spätnými apostrofmi aj odsadené bloky, vykreslené v rámovanom, vyplnenom rámčeku neproporcionálnym písmom, takže sa blok odlišuje od textu a ASCII diagramy aj zarovnané stĺpce si udržia svoju podobu.
• Odkazy a obrázky — v riadku, odkazom na definíciu ([text][ref] s definíciou kdekoľvek v súbore) a holé adresy http://, https:// alebo www., ktoré sa odkazmi stanú samy. Cesty k obrázkom sa vyhodnocujú relatívne k súboru.
• Citácie a vodorovné čiary.
• YAML front matter — blok metadát --- … ---, ktorý niektoré nástroje očakávajú hneď na začiatku súboru, sa zobrazí ako blok kódu yaml a nezamení sa za nadpis.

Surové HTML sa zobrazí ako text, zámerne: značky sa escapujú, namiesto toho, aby sa spúšťali, takže náhľad dokumentu, ktorý ste nenapísali vy, nemôže nič spustiť. Bloky HTML a poznámky pod čiarou sa nevykresľujú.

Ktoré odkazy sa otvárajú

Kliknutie na odkaz v náhľade ho otvorí len vtedy, keď je cieľom http, https alebo mailto; #fragment posunie náhľad na daný nadpis. Každý iný cieľ — cesta file:, obyčajná či relatívna cesta, adresa javascript:, vlastná schéma nejakej aplikácie — sa ignoruje a stavový riadok povie, ktorý odkaz sa neotvoril a prečo. Dôvodom je samotný dokument: markdownový súbor, ktorý ste naklonovali alebo stiahli, je cudzí text a jediné kliknutie v ňom nesmie byť schopné spustiť program na vašom počítači.

Podržanie ukazovateľa nad odkazom ukáže, kam vedie, ešte pred kliknutím — a na druhom riadku aj to, že ide o odkaz, ktorý náhľad neotvorí.

Pozri aj

• Náhľad HTML — plnohodnotný náhľad (CSS/JavaScript) pre HTML a PHP pomocou QtWebEngine.
• Editor motívov — úprava farieb Markdown v náhľade.