Gå till innehållet

Insticksmodulen Markdown-förhandsgranskning

En löpande förhandsgranskning sida vid sida av det aktiva Markdown-dokumentet, återgiven i en dockningsbar panel som uppdateras medan du skriver. Renderaren har inga beroenden (den använder Qt:s inbyggda vy för formaterad text, inte en webbmotor), så den här insticksmodulen är alltid tillgänglig och lägger inte till några tunga beroenden.

Var du hittar den

Visa ▸ Markdown-förhandsgranskning öppnar (eller stänger) förhandsgranskningsdockan för den aktuella fliken. Dockan föredrar högersidan och kan dras, flyttas ut eller flikläggas som vilken annan panel som helst.

Hur den beter sig

  • Löpande rendering. Förhandsgranskningen renderas om medan du skriver, med fördröjning så att skrivandet förblir responsivt (fördröjningen mjukas upp automatiskt för mycket stora filer).
  • Följ markören. Med Följ markören aktiverat (verktygsfältet) rullar förhandsgranskningen till det block du redigerar så snart markören flyttar till en annan rad. Eftersom bara en markörflytt rullar den tar en sökning förhandsgranskningen till träffen och lämnar den sedan i fred: du kan rulla bort från träffen och förhandsgranskningen stannar där du satte den, till du flyttar markören igen. Stäng av alternativet för att rulla förhandsgranskningen helt fristående. Inställningen kommer ihåg.
  • Temamedveten. Förhandsgranskningens färger kommer från det aktiva redigerartemat (text, kodblock, blockcitat, länkar), så att förhandsgranskningen matchar ett ljust eller mörkt tema och uppdateras löpande när du byter tema. Du kan finjustera de här färgerna i Temaredigeraren under kategorierna Markdown.
  • Exportera / öppna i webbläsare. Verktygsfältet kan exportera den renderade HTML-koden till en fil eller öppna den i din standardwebbläsare. I båda fallen får du en ren, fristående sida: enkel, semantisk uppmärkning utan den ställning panelen behöver för sin egen del, och en fast ljus formatmall, så att den delade filen läses normalt oavsett ditt redigerartema.
  • Panelens storlek. Förhandsgranskningen behåller en andel av fönstret i stället för en fast bredd, så den växer och krymper med fönstret — se Sparad layout.

Förhandsgranskningens synlighet

Förhandsgranskningens synlighet kommer ihåg per fil, både under en session och mellan omstarter:

  • Markdown-filer (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) öppnar förhandsgranskningen automatiskt första gången du tittar på dem. Den här standarden för «öppna automatiskt» är en bestående växel under Visa ▸ Öppna Markdown-förhandsgranskning automatiskt.
  • Andra filer gör det inte — men du kan öppna förhandsgranskningen för vilken fil som helst med Visa ▸ Markdown-förhandsgranskning, och den återger den filen som Markdown.
  • Inom en session återställs det du väljer för en flik när du växlar tillbaka till den.
  • Mellan omstarter kommer ditt uttryckliga val för en fil ihåg: stäng förhandsgranskningen för en fil så förblir den stängd nästa gång du öppnar den filen; öppna förhandsgranskningen för en fil som inte skulle öppnas automatiskt så öppnas den igen. Filer du aldrig uttryckligen rört följer helt enkelt standarden för automatiskt öppnande varje gång — så att slå på automatiskt öppnande senare öppnar ändå de förhandsgranskningar du aldrig avsiktligt stängt.

Vad den renderar

  • Formatering i raden — *kursiv*, **fet**, ***fet kursiv***, ~~genomstruken~~, kod i raden och hårda radbrytningar.
  • Rubriker — både #-formen och den understrukna (setext) formen.
  • Listor — ordnade och oordnade, nästlade, tätt eller luftigt satta (en luftig lista får styckeavstånd), med start på det tal du skrev, och uppgiftslistor: - [ ] och - [x] blir ☐ och ☑.
  • Tabeller — tabeller med lodstreck och justering per kolumn (vänster, centrerad, höger). En för kort rad fylls ut, en cell för mycket faller bort, och en bred tabell radbryts i stället för att klippas.
  • Kod — både block med staket och indragna block, ritade i en inramad, ifylld ruta i ett teckensnitt med fast bredd, så att ett block avtecknar sig mot texten och ASCII-diagram och justerade kolumner behåller sin form.
  • Länkar och bilder — i raden, som referens ([text][ref] med definitionen var som helst i filen) och nakna http://-, https://- eller www.-adresser, som blir länkar av sig själva. Bildsökvägar löses upp relativt filen.
  • Blockcitat och vågräta linjer.
  • YAML-frontmatter — metadatablocket --- … --- som vissa verktyg förväntar sig allra först i en fil visas som ett yaml-kodblock, inte som en rubrik.

Rå HTML visas som text, med avsikt: uppmärkning escapas i stället för att köras, så att förhandsgranska ett dokument du inte skrivit själv inte kan köra något. HTML-block och fotnoter renderas inte.

Vilka länkar öppnas

Att klicka på en länk i förhandsgranskningen öppnar den bara när destinationen är http, https eller mailto; ett #fragment rullar förhandsgranskningen till den rubriken. Varje annan destination — en file:-sökväg, en vanlig eller relativ sökväg, en javascript:-adress, något programs eget schema — ignoreras, och statusraden säger vilken länk som inte öppnades och varför. Skälet är dokumentet självt: en Markdown-fil du klonat eller hämtat är någon annans text, och ett enda klick i den får inte kunna starta ett program på din dator.

Att hålla pekaren över en länk visar vart den leder innan du klickar, med en andra rad när det är en länk förhandsgranskningen inte kommer att öppna.

Se även