Indstilling af forudsætninger:
For at se, hvordan indlejringen af listen fungerer, har vi brug for et værktøj eller software, hvor vi kan implementere markdown-scriptet. Vi har fundet Visual Studio Code som den bedste assembler til markdown-scripts. For at implementere markdown-sproget er vi nødt til at foretage nogle ændringer i henhold til vores opgavekrav. Vi har lanceret VS-koden og oprettet en ny projektfil. Som standard åbner den en simpel tekstfil, men vi skal arbejde med markdown, så vi ændrer filtypen. Indstillingen 'Almindelig tekst' kan findes i højre hjørne af statuslinjen og bruges til at ændre filtypen. Når du placerer markøren på den, beder den om at vælge sprogtilstand.
Når du trykker på den, vises en menu. Du skal bare skrive 'Markdown' for at vælge markdown-sproget.
Dette vil ændre vores filtype fra 'Almindelig tekst' til en 'Markdown'.
Du kan se i det foregående snapshot, at filtypen nu er 'Markdown'.
Derefter skal vi tilføje en udvidelse, for at markdown-scripts kan forhåndsvises og fungere korrekt. For at tilføje denne udvidelse fra venstre værktøjslinje vil indstillingsmuligheden give dig en valgboks, hvor vi har valgt 'Udvidelse'.
Dette åbner et vindue. Vi skal skrive udvidelsesnavnet som 'Markdown All in One' og installere det.
Nu er markdown-udvidelsen tilføjet til vores fil.
Den sidste ting, vi skal gøre, er at åbne et forhåndsvisningsvindue for at se outputtet af vores genererede scripts. Forhåndsvisningsvinduet kan startes ved at klikke på tasterne 'Ctrl+Shift+V', eller du kan klikke på ikonet med en tast i øverste højre hjørne af værktøjet.
Hvis du klikker på det, opdeles vinduet i to skærme. Den første vil blive brugt til at indtaste scripts, mens outputtet af scriptet vil blive vist i 'Preview' vinduet.
Vi kan nu bruge dette værktøj til at begynde at arbejde med markdown-scripts. Lad os udforske scripts nu.
Undslippende backticks i Markdown:
I Markdown bruges backticks til at skabe kodeblokke. Når vi indsætter et backtick, refererer det til at starte et kodestykke i Markdown. Et enkelt backtick tilføjes i begyndelsen og slutningen af hver linje kode for at skabe inline kodeblokke i dokumenter. På grund af disse backticks bliver det svært at vise backticks som tekst i et dokument uden at aktivere kodeblokgenerering. I denne øvelse skal vi arbejde på, hvordan vi kan undslippe et backtick, så vi kan inkludere det som en tekst i stedet for at behandle det som begyndelsen på kodesyntaks.
Den enkleste måde at springe et backtick over er at tilføje en backtick (\), før du indsætter backtick. Hvis du ikke tilføjer en omvendt skråstreg, indsættes det backtick, du vil tilføje som en tekst, og det næste backtick i koden. Uanset hvilken tekst du ville have tilføjet imellem dem, vil det blive betragtet som en kodeblok, så indsæt en omvendt skråstreg for at undgå dette. Vi vil først tilføje backticks for at generere en kodeblok og derefter lære at undslippe backtick i markdown i denne demonstration.
Vi har først oprettet en header til vores dokument. For at generere overskriften på første niveau skal vi indsætte et enkelt hash-symbol (#), tilføje et mellemrum og derefter nævne teksten til overskriften. Vi har angivet teksten som 'Markdown Backtick'. For nu at oprette en kodeblok, har vi først tilføjet et backtick (`) og giver et mellemrum efter det. Derefter skrev vi teksten som 'Sample Text', efterfulgt af et mellemrum, hvor det afsluttende backtick er anvendt. Nu vil disse to backticks betragte teksten mellem dem som et kodestykke og vil således gengive det som en kodeblok.
Dette giver os en overskrift 'Markdown Backtick' og den tekst, vi har nævnt ovenfor i kodeblokformatet. Du kan se det forventede resultat i det øjebliksbillede af forhåndsvisningsvinduet, vi har leveret nedenfor:
Nu, for at undslippe denne backtick og gengive teksten som almindelig tekst og ikke en kodeblok, skal vi bruge backslash (\) før start backtick og også før den afsluttende backtick. Så vi ville gøre dette trick på ovenstående kodeblok for at gengive den som en almindelig tekst ved at tilføje omvendte skråstreg.
Vi har lavet en header med teksten 'Markdown Escaping a Backtick'. Efter at have sprunget en linje over, tilføjede vi en skråstreg efterfulgt af et backtick. Der gives plads, og derefter angives teksten som 'Sample Text'. Før vi tilføjer det afsluttende backtick, har vi indsat endnu en backslash.
Preview-vinduet viser det forventede resultat, hvor tekststrengen vises som en almindelig tekst med backticks. Så vi har tilføjet backtikken uden at udløse dens funktionalitet for at vende teksten til kodeblokken.
I ovenstående tilfælde er teksten pakket ind mellem to backticks. Hvis vi ønsker at tilføje et enkelt backtick i kodeblokken uden at betragte det som syntaksen til at generere kodeblokken. Til dette har vi tilføjet to backticks, et mellemrum og derefter teksten som 'Vi tilføjer et backtick: ` '. Du kan se, at vi her ønsker at vise backtikken uden at bruge det som en del af syntaksen. Derefter gav vi plads og tilføjede to afsluttende backticks.
Det forventede output vises. Dette har en kodeblok, der har et backtick som en del af det.
Nu vil vi skabe endnu et eksempel for at forstå konceptet. Her vil vi lave et matematisk udtryk og skrive det som en kodeblok i markdown på linje med almindelig tekst. Vi har skrevet det som 'Hvis `y = 9`, betyder det, at `y -3 = 6`'. Her har vi brugt backticks på 'y = 9' og derefter på 'y-3 = 6' for at lave dem begge kodeblokke.
Så det gav os det forventede output, som kan ses på billedet nedenfor:
Nu, for at undslippe disse backticks og for at gengive backticks som en del af almindelig tekst, er vi nødt til at indsætte backticks før begge par af backticks.
Det matematiske udtryk, vi har tilføjet, vises med backticks som almindelig tekst og som en kodeblok i markdown.
Konklusion
Backticks tilføjes i markdown for at få en bestemt tekst eller script vist i kodeblokken. I denne guide har vi diskuteret behovet for at undslippe backtick, når vi vil tilføje indhold som en almindelig tekst med backticks uden at udløse deres funktionalitet. Vi har diskuteret, hvordan backticks anvendes til at lave kodeblokkene, og så har vi givet dig en løsning, som er at tilføje en backtick (\) før backticket, så det vil blive vist som en almindelig tekst og ikke ville aktivere kodeblokken skabelse.