Markdown-esikatselu-liitännäinen

Reaaliaikainen, vierekkäinen esikatselu aktiivisesta Markdown-asiakirjasta, piirrettynä telakoitavaan paneeliin, joka päivittyy kirjoittaessasi. Piirtäjä on riippuvuudeton (se käyttää Qt:n sisäänrakennettua muotoillun tekstin näkymää, ei selainmoottoria), joten tämä liitännäinen on aina käytettävissä eikä lisää raskaita riippuvuuksia.

Mistä sen löytää

Näytä ▸ Markdown-esikatselu avaa (tai sulkee) esikatselutelakan nykyiselle välilehdelle. Telakka suosii oikeaa laitaa ja sitä voi vetää, kelluttaa tai laittaa välilehdiksi kuten mitä tahansa muuta paneelia.

Miten se käyttäytyy

• Reaaliaikainen piirto. Esikatselu piirretään uudelleen kirjoittaessasi, viiveellä, jotta kirjoittaminen pysyy sujuvana (viive löystyy automaattisesti hyvin suurissa tiedostoissa).
• Seuraa kohdistinta. Kun Seuraa kohdistinta on käytössä (työkalurivillä), esikatselu vierii muokkaamasi lohkon kohdalle heti, kun kohdistin siirtyy toiselle riville. Koska vain kohdistimen siirto vierittää sitä, haku vie esikatselun osumaan ja jättää sen sitten rauhaan: voit vierittää osumasta pois, ja esikatselu jää siihen mihin sen jätit, kunnes siirrät kohdistinta uudelleen. Kytke valinta pois vierittääksesi esikatselua täysin erikseen. Asetus muistetaan.
• Teematietoinen. Esikatselun värit tulevat aktiivisesta editoriteemasta (teksti, koodilohkot, lainauslohkot, linkit), joten esikatselu vastaa vaaleaa tai tummaa teemaa ja päivittyy heti, kun vaihdat teemaa. Voit hienosäätää näitä värejä Teemaeditorissa Markdown-luokkien alla.
• Vie tai avaa selaimessa. Työkalurivi voi viedä piirretyn HTML:n tiedostoon tai avata sen oletusselaimessasi. Kummallakin tavalla saat siistin, itsenäisen sivun: yksinkertaista, semanttista merkkausta ilman sitä telinettä, jota paneeli tarvitsee vain itselleen, ja kiinteän vaalean tyylitiedoston, joten jaettu tiedosto näyttää normaalilta editoriteemastasi riippumatta.
• Paneelin koko. Esikatselu pitää osuutensa ikkunasta kiinteän leveyden sijaan, joten se kasvaa ja kutistuu ikkunan mukana — katso Tallennettu asettelu.

Esikatselun näkyvyys

Esikatselun näkyvyys muistetaan tiedostokohtaisesti, sekä istunnon aikana että uudelleenkäynnistysten yli:

• Markdown-tiedostot (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) avaavat esikatselun itsestään, kun katsot niitä ensimmäistä kertaa. Tämä »automaattisen avauksen« oletus on pysyvä kytkin kohdassa Näytä ▸ Avaa Markdown-esikatselu automaattisesti.
• Muut tiedostot eivät tee niin — mutta voit avata esikatselun mille tahansa tiedostolle komennolla Näytä ▸ Markdown-esikatselu, ja se piirtää tuon tiedoston Markdownina.
• Istunnon sisällä se, minkä valitset välilehdelle, palautetaan, kun palaat siihen.
• Uudelleenkäynnistysten yli nimenomainen valintasi tiedostolle muistetaan: sulje esikatselu tiedostolta, niin se pysyy suljettuna seuraavalla kerralla, kun avaat tuon tiedoston; avaa esikatselu tiedostolle, joka ei avaisi sitä itsestään, niin se avautuu uudelleen. Tiedostot, joita et koskaan nimenomaisesti koskettanut, noudattavat yksinkertaisesti automaattisen avauksen oletusta joka kerta — joten automaattisen avauksen kytkeminen päälle myöhemmin avaa silti esikatselut, joita et koskaan tarkoituksella sulkenut.

Mitä se piirtää

• Rivin sisäinen muotoilu — *kursivointi*, **lihavointi**, ***lihava kursiivi***, ~~yliviivaus~~, rivin sisäinen koodi ja kovat rivinvaihdot.
• Otsikot — sekä #-muoto että alleviivattu (setext) muoto.
• Luettelot — numeroidut ja numeroimattomat, sisäkkäiset, tiiviit tai väljät (väljä luettelo saa kappaleiden välit), alkaen siitä numerosta jonka kirjoitit, ja tehtäväluettelot: - [ ] ja - [x] piirtyvät merkeiksi ☐ ja ☑.
• Taulukot — putkimerkkitaulukot sarakekohtaisella tasauksella (vasen, keskitetty, oikea). Liian lyhyt rivi täytetään, liika solu jätetään pois, ja leveä taulukko rivittyy sen sijaan että se leikkautuisi.
• Koodi — sekä aidatut että sisennetyt lohkot, piirrettyinä reunustettuun, täytettyyn laatikkoon tasalevyisellä kirjasimella, jotta lohko erottuu tekstistä ja ASCII-kaaviot ja tasatut sarakkeet pitävät muotonsa.
• Linkit ja kuvat — rivin sisäiset, viittaustyyliset ([teksti][ref] ja määritys missä tahansa tiedostossa) sekä paljaat http://-, https://- ja www.-osoitteet, joista tulee linkkejä itsestään. Kuvapolut ratkaistaan suhteessa tiedostoon.
• Lainauslohkot ja vaakaviivat.
• YAML-alkulohko — --- … --- -metatietolohko, jota jotkin työkalut odottavat tiedoston alkuun, näytetään yaml-koodilohkona eikä sitä luulla otsikoksi.

Raaka HTML näytetään tekstinä, tarkoituksella: merkkaus suojataan sen sijaan että se suoritettaisiin, joten sellaisen asiakirjan esikatselu, jota et ole itse kirjoittanut, ei voi ajaa mitään. HTML-lohkoja ja alaviitteitä ei piirretä.

Mitkä linkit avautuvat

Linkin napsauttaminen esikatselussa avaa sen vain, kun kohde on http, https tai mailto; #fragment vierittää esikatselun kyseiseen otsikkoon. Kaikki muut kohteet — file:-polku, tavallinen tai suhteellinen polku, javascript:-osoite, jonkin sovelluksen oma skeema — ohitetaan, ja tilarivi kertoo, mitä linkkiä ei avattu ja miksi. Syy on asiakirja itse: Markdown-tiedosto, jonka olet kloonannut tai ladannut, on jonkun toisen tekstiä, eikä yksi napsautus siinä saa voida käynnistää ohjelmaa koneellasi.

Linkin päällä viipyminen näyttää ennen napsautusta, minne se johtaa, ja toisella rivillä sen, jos esikatselu ei aio avata sitä.

Katso myös

• HTML-esikatselu — täysin todenmukainen esikatselu (CSS ja JavaScript) HTML:lle ja PHP:lle QtWebEnginen avulla.
• Teemaeditori — säädä esikatselun Markdown-värejä.