Gå til innhold

Markdown-forhåndsvisning-programtillegget

En løpende forhåndsvisning av det aktive Markdown-dokumentet side om side med teksten, gjengitt i et dokkbart panel som oppdateres mens du skriver. Gjengiveren er uten avhengigheter (den bruker Qts innebygde visning av formatert tekst, ikke en nettlesermotor), så dette programtillegget er alltid tilgjengelig og legger ikke til noen tunge avhengigheter.

Hvor du finner det

Vis ▸ Markdown-forhåndsvisning åpner (eller lukker) forhåndsvisningspanelet for den gjeldende fanen. Panelet foretrekker høyre side og kan dras, gjøres flytende eller legges i faner som ethvert annet panel.

Slik oppfører den seg

  • Løpende gjengivelse. Forhåndsvisningen gjengis på nytt mens du skriver, med en forsinkelse, så det fortsetter å være behagelig å skrive (forsinkelsen slakkes av seg selv i svært store filer).
  • Følg markøren. Med Følg markøren på (på verktøylinjen) ruller forhåndsvisningen til den blokken du redigerer, så snart markøren flytter til en annen linje. Siden bare en markørflytting ruller den, tar et søk forhåndsvisningen til treffet og lar den deretter være: du kan rulle bort fra treffet, og forhåndsvisningen blir stående der du satte den, til du flytter markøren igjen. Slå av valget for å rulle forhåndsvisningen helt for seg. Innstillingen huskes.
  • Følger temaet. Forhåndsvisningens farger kommer fra det aktive redigerertemaet (tekst, kodeblokker, blokksitater, lenker), så forhåndsvisningen passer til et lyst eller mørkt tema og oppdateres med det samme når du bytter tema. Du kan finjustere disse fargene i Temaredigereren under Markdown-kategoriene.
  • Eksporter eller åpne i nettleseren. Verktøylinjen kan eksportere den gjengitte HTML-en til en fil eller åpne den i standardnettleseren din. Begge veier får du en ren, selvstendig side: enkel, semantisk oppmerking uten stillaset panelet bare trenger for sin egen del, og et fast lyst stilark, så den delte filen ser normal ut uansett redigerertemaet ditt.
  • Panelstørrelse. Forhåndsvisningen holder en andel av vinduet i stedet for en fast bredde, så den vokser og krymper med vinduet — se Lagret oppsett.

Forhåndsvisningens synlighet

Forhåndsvisningens synlighet huskes per fil, både i løpet av en økt og på tvers av omstarter:

  • Markdown-filer (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) åpner forhåndsvisningen av seg selv første gang du ser dem. Denne standarden om «automatisk åpning» er en varig bryter under Vis ▸ Åpne Markdown-forhåndsvisningen automatisk.
  • Andre filer gjør ikke det — men du kan åpne forhåndsvisningen på enhver fil med Vis ▸ Markdown-forhåndsvisning, og den vil gjengi den filen som Markdown.
  • Innenfor en økt gjenopprettes det du velger for en fane, når du kommer tilbake til den.
  • På tvers av omstarter huskes ditt uttrykkelige valg for en fil: lukker du forhåndsvisningen på en fil, blir den lukket neste gang du åpner den filen; åpner du forhåndsvisningen på en fil som ikke ville åpnet den av seg selv, åpnes den igjen. Filer du aldri uttrykkelig har rørt, følger ganske enkelt standarden for automatisk åpning hver gang — så slår du automatisk åpning på senere, åpnes forhåndsvisninger du aldri bevisst har lukket, likevel.

Hva den gjengir

  • Formatering i linjen — *kursiv*, **halvfet**, ***halvfet kursiv***, ~~gjennomstreket~~, kode i linjen og harde linjeskift.
  • Overskrifter — både #-formen og den understrekede (setext) formen.
  • Lister — nummererte og unummererte, nestede, tette eller luftige (en luftig liste får avstand som avsnitt), med start på det tallet du skrev, og oppgavelister: - [ ] og - [x] blir ☐ og ☑.
  • Tabeller — tabeller med loddrette streker og justering per kolonne (venstre, midtstilt, høyre). En for kort rad fylles ut, en celle for mye faller bort, og en bred tabell brytes i stedet for å klippes.
  • Kode — både inngjerdede og innrykkede blokker, tegnet i en innrammet, fylt boks i en skrift med fast bredde, så en blokk skiller seg fra teksten og ASCII-diagrammer og justerte kolonner holder formen sin.
  • Lenker og bilder — i linjen, som referanse ([tekst][ref] med definisjonen hvor som helst i filen) og nakne http://-, https://- eller www.-adresser, som blir lenker av seg selv. Bildestier finnes i forhold til filen.
  • Blokksitater og vannrette streker.
  • YAML-frontmateriale — metadatablokken --- … --- som noen verktøy forventer helt først i en fil, vises som en yaml-kodeblokk og tas ikke for en overskrift.

Rå HTML vises som tekst, med vilje: oppmerking unnvikes i stedet for å kjøres, så det å forhåndsvise et dokument du ikke har skrevet selv, ikke kan kjøre noe som helst. HTML-blokker og fotnoter gjengis ikke.

Hvilke lenker åpnes

Et klikk på en lenke i forhåndsvisningen åpner den bare når målet er http, https eller mailto; et #fragment ruller forhåndsvisningen til den overskriften. Alle andre mål — en file:-sti, en vanlig eller relativ sti, en javascript:-adresse, et eller annet programs eget skjema — ignoreres, og statuslinjen sier hvilken lenke som ikke ble åpnet, og hvorfor. Grunnen er dokumentet selv: en Markdown-fil du har klonet eller lastet ned, er en annens tekst, og ett enkelt klikk i den skal ikke kunne starte et program på maskinen din.

Å holde pekeren over en lenke viser hvor den fører, før du klikker, med en annen linje når det er en lenke forhåndsvisningen ikke kommer til å åpne.

Se også