Gå til indholdet

Markdown-forhåndsvisning-udvidelsesmodulet

En levende forhåndsvisning af det aktive Markdown-dokument side om side med teksten, gengivet i et panel, der kan dokkes, og som opdateres, mens du skriver. Gengiveren er uden afhængigheder (den bruger Qts indbyggede visning af formateret tekst, ikke en webmotor), så dette udvidelsesmodul er altid til rådighed og tilføjer ingen tunge afhængigheder.

Hvor du finder det

Vis ▸ Markdown-forhåndsvisning åbner (eller lukker) forhåndsvisningspanelet for det aktuelle faneblad. Panelet foretrækker højre side og kan trækkes, gøres flydende eller lægges i faneblade som ethvert andet panel.

Sådan opfører den sig

  • Levende gengivelse. Forhåndsvisningen gengives på ny, mens du skriver, med en forsinkelse, så det bliver ved med at være behageligt at skrive (forsinkelsen slækkes automatisk i meget store filer).
  • Følg markøren. Med Følg markøren slået til (på værktøjslinjen) ruller forhåndsvisningen til den blok, du redigerer, så snart markøren flytter til en anden linje. Da kun en markørflytning ruller den, fører en søgning forhåndsvisningen hen til fundet og lader den derefter være: du kan rulle væk fra fundet, og forhåndsvisningen bliver stående, hvor du satte den, indtil du flytter markøren igen. Slå indstillingen fra for at rulle forhåndsvisningen helt uafhængigt. Indstillingen huskes.
  • Tilpasser sig temaet. Forhåndsvisningens farver kommer fra det aktive editortema (tekst, kodeblokke, blokcitater, links), så forhåndsvisningen passer til et lyst eller mørkt tema og opdateres med det samme, når du skifter tema. Du kan finjustere disse farver i Temaeditoren under kategorierne Markdown.
  • Eksportér eller åbn i browser. Værktøjslinjen kan eksportere den gengivne HTML til en fil eller åbne den i din standardbrowser. Begge veje får du en ren, selvstændig side: enkel, semantisk opmærkning uden det stillads, panelet kun behøver til sig selv, og et fast lyst stilark, så den delte fil ser normal ud uanset dit editortema.
  • Panelets størrelse. Forhåndsvisningen holder en andel af vinduet i stedet for en fast bredde, så den vokser og skrumper med vinduet — se Gemt layout.

Forhåndsvisningens synlighed

Forhåndsvisningens synlighed huskes pr. fil, både i løbet af en session og på tværs af genstarter:

  • Markdown-filer (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) åbner forhåndsvisningen af sig selv, første gang du ser dem. Denne standard for »automatisk åbning« er en vedvarende indstilling under Vis ▸ Åbn Markdown-forhåndsvisning automatisk.
  • Andre filer gør ikke — men du kan åbne forhåndsvisningen på enhver fil med Vis ▸ Markdown-forhåndsvisning, og den vil gengive den fil som Markdown.
  • Inden for en session gendannes det, du vælger for et faneblad, når du vender tilbage til det.
  • På tværs af genstarter huskes dit udtrykkelige valg for en fil: lukker du forhåndsvisningen på en fil, bliver den lukket, næste gang du åbner den fil; åbner du forhåndsvisningen på en fil, der ikke ville åbne den af sig selv, åbnes den igen. Filer, du aldrig udtrykkeligt har rørt, følger simpelthen standarden for automatisk åbning hver gang — så slår du automatisk åbning til senere, åbnes forhåndsvisninger, du aldrig bevidst har lukket, stadig.

Hvad den gengiver

  • Opmærkning i linjen — *kursiv*, **fed**, ***fed kursiv***, ~~gennemstreget~~, kode i linjen og hårde linjeskift.
  • Overskrifter — både #-formen og den understregede (setext) form.
  • Lister — nummererede og unummererede, indlejrede, tætte eller luftige (en luftig liste får afstand som afsnit), begyndende ved det tal, du skrev, og opgavelister: - [ ] og - [x] bliver ☐ og ☑.
  • Tabeller — tabeller med lodrette streger og justering pr. kolonne (venstre, centreret, højre). En for kort række fyldes ud, en celle for meget falder bort, og en bred tabel ombrydes i stedet for at blive klippet.
  • Kode — både indhegnede og indrykkede blokke, tegnet i en indrammet, udfyldt boks i en skrift med fast bredde, så en blok skiller sig ud fra teksten, og ASCII-diagrammer og justerede kolonner bevarer deres form.
  • Links og billeder — i linjen, som reference ([tekst][ref] med definitionen hvor som helst i filen) og nøgne http://-, https://- eller www.-adresser, der bliver links af sig selv. Billedstier findes i forhold til filen.
  • Blokcitater og vandrette streger.
  • YAML-frontstof — metadatablokken --- … ---, som nogle værktøjer forventer allerførst i en fil, vises som en yaml-kodeblok og tages ikke for en overskrift.

Rå HTML vises som tekst, med vilje: opmærkning undviges i stedet for at køres, så det at forhåndsvise et dokument, du ikke selv har skrevet, ikke kan køre noget som helst. HTML-blokke og fodnoter gengives ikke.

Et klik på et link i forhåndsvisningen åbner det kun, når målet er http, https eller mailto; et #fragment ruller forhåndsvisningen hen til den overskrift. Alle andre mål — en file:-sti, en almindelig eller relativ sti, en javascript:-adresse, et eller andet programs eget skema — ignoreres, og statuslinjen siger, hvilket link der ikke blev åbnet, og hvorfor. Grunden er dokumentet selv: en Markdown-fil, du har klonet eller hentet, er en andens tekst, og et enkelt klik i den må ikke kunne starte et program på din maskine.

At holde markøren over et link viser, hvor det fører hen, før du klikker, med en anden linje, når det er et link, forhåndsvisningen ikke vil åbne.

Se også

  • HTML-forhåndsvisning — fuldtro forhåndsvisning (CSS og JavaScript) af HTML og PHP med QtWebEngine.
  • Temaeditor — justér forhåndsvisningens Markdown-farver.