Markdown Table of Content
Opprette innholdsfortegnelse i markdown:
En tabell med innhold kan opprettes i et dokument ved hjelp av Native Markdown Syntax. Denne opplæringen vil hjelpe oss å lære generering av innholdsinnholdet.
For den praktiske implementeringen av Markdown -skriptene trenger vi et verktøy som støtter Markdown -språket. Vi har valgt Visual Studio -koden for sammenstilling av eksempelkoder. Etter å ha lansert verktøyet, opprettet vi en ny fil og satte sin type til “Markdown.”For å åpne forhåndsvisningsvinduet, må du bare treffe“ Ctrl+Shift+V ”-tastene. Nå har vi en "markdown" -fil og et forhåndsvisningsvindu som tilsvarer den.
Verktøyet for å sammenstille skriptet er satt nå. Opprettelsen av innholdstabellen vil begynne etterpå. I Markdown -filen opprettet vi først en overskrift. For å opprette en overskrift, er vi pålagt å legge til et hasj (#) symbol. Å legge til en enkelt hasj (#) refererer til det første nivået. Etter hasjsymbolet må det gis et rom før du skriver teksten til overskriften din. Teksten vi har spesifisert for dokumentets overskrift er “Innholdsfortegnelse.”Dette vil skape en overskrift med H1 -størrelse øverst på websiden vår.
Så hoppet vi over noen linjer før vi skrev neste skript. Nå lager vi en liste over innholdsoverskrifter som er tilgjengelige i dokumentet. For å lage en markdown -liste, har vi to valg: om vi skal lage bestilte lister eller uordnede lister. For listegenerering må vi skrive en numerisk verdi og legge til en prikk (.) Umiddelbart etter det. Så, etter et rom, nevner listeelementene. For listeelementene her, må vi lage markdown -koblinger som vil lede oss til en bestemt del av dokumentet når vi klikker på dem.
Så vi la til det første listeelementet med den numeriske verdien “1” og deretter for å opprette lenken til en del av siden, skrev vi først overskriftstittelen innenfor de firkantede parentesene etterfulgt av runde seler som vil holde en hasj (#) symbol og tittelen på overskriften det kan rette brukeren. Du kan ikke gi noen fane eller plass i de runde seler når du legger til lenker til en del av dokumentet. I stedet kan du bruke streker (-) hvor som trengs som erstatning for mellomrom. Så for det første listeelementet har vi lagt til lenken som “1. [Introduksjon] (#Introduksjon).”
Teksten i den firkantede braketten vises som den er, og når vi klikker på den, vil den bla til den delen av dokumentet der det vil finne den samme overskriftsteksten som vi har gitt i de runde selene. Den andre listeartikelen er vedlagt som “2. [Emne 1] (#Topic-1).”Her vil“ Emne 1 ”bli gjengitt som det er, og“#Topic-1 ”vil bli innebygd som en seksjonslenke. Det tredje listeelementet har teksten “3. [Emne 2] (#emne-2).”Og det siste elementet har det som“ 4. [Emne 3] (#emne-3).”
Nå vil vi lage underoverskrifter med samme tittel som nevnt i listeseksjonslenken. For å lage underoverskriftene, må vi bruke doble hashes (##). Etter symbolene, legg et rom og deretter innskriv overskriften, som skal være den samme som definert for lenken i listen over. Hvis vi legger til en annen tittel, fungerer ikke lenken. Så vi la til den første underoverskriften etter å ha satt inn hasjene som “Introduksjon.”For andre, tredje og fjerde overskrifter er titlene henholdsvis" Tema 1 "," Emne 2 "og" Emne 3 ".
Forhåndsvisningsvinduet viser oss det tilsvarende forventede utfallet for dette Markdown -skriptet, der en innholdsfortegnelse genereres med 4 listeelementer og deres referanseoverskrifter er vist under dem.
Alle disse er tekstinnhold. Vi kan også legge til en ekstern lenke som en overskrift i innholdstabellen. Vi vil følge det samme mønsteret som vi brukte i den forrige opprettelsen av listen, bortsett fra en ting. Vi vil også legge til en lenke til nettstedet med seksjonslenken i rundkonsoller. For dette har vi først opprettet et annet listeelement som “5. [Emne 4] (#emne-5httpwwwyahoocom).”Du kan se at vi ikke har lagt til noen prikker i nettstednavnet.
Nå må vi lage en overskrift som tilsvarer denne lenken. Så vi la til doble hasj og plass, og her vil vi ikke bare skrive teksten for tittelen; I stedet vil vi opprette en lenke. Først skrev vi koblingsteksten, som vi satte inn den samme som spesifisert for det nye listeelementet “[Emne 5].”Så satte vi inn runde parenteser umiddelbart etter de firkantede parentesene og skrev den komplette nettstedlenken som“ http: // www.Yahoo.com ”.
Dette vil legge til en annen overskrift til innholdsfortegnelsen, men det er en lenke, ikke bare en ren tekst.
Du kan se at den siste overskriften er understreket, som representerer indikerer at det er en lenke. Når vi klikker på den, åpner den den spesifiserte nettadressen i nettleseren. Her har vi gitt “yahoo.com ”. Så det vil åpne Yahoo i nettleseren vår.
Vi har generert innholdsfortegnelsen i Markdown, som har noen overskrifter og en liste i den. Nå får vi se hvordan vi kan legge til underoverskrifter til hovedoverskriftene på listen.
Fra innholdslisten vi har generert tidligere, har vi valgt de 2nd Listeelement, som har tittelen “Emne 1”. For å opprette en barneliste, må vi legge inn to mellomrom i linjen ved siden av foreldrelisteelementet. Etter å ha gitt mellomrommene, nummererte vi listen som “1.”Så brukte vi de firkantede parentesene for å spesifisere titlene, fulgt umiddelbart av runde parenteser for å gi en lenke til den spesifikke delen av dokumentet. Så vi la til to barnelisteartikler som “1. [Sub-Topic 1] (#Sub-Topic-1) ”og i neste linje er det andre elementet“ 2. [Sub-Topic 2] (#Sub-Topic-2.) ”
Deretter, som flytter til innholdsdelen av dokumentet, har vi lagt til to nye underoverskrifter. For å lage underoverskrifter med nivå 3, må vi legge til 3 hash (#) symboler etterfulgt av et rom og teksten til underhodet. Vi har spesifisert de samme titlene som vi har nevnt for å koble seksjonene på listen. Den første underoverskriften har tittelen “Sub-Topic 1”, og den andre er “Sub-Topic 2.”
I øyeblikksbildet av forhåndsvisningsvinduet nedenfor, kan du se at underoverskriftene er blitt lagt til sammen med innholdsfortegnelsen vår.
Konklusjon
Innholdsfortegnelsen (TOC) kan genereres manuelt i et Markdown -dokument. I denne guiden jobbet vi med Markdowns evne til å tillate generering av en innholdsfortegnelse manuelt. Vi har utført kodebitene og utdypet all syntaks som brukes og trinn som må utføres. Vi lærte å lage en enkel innholdsfortegnelse med en markdown -liste og overskrifter. Å legge inn eksterne lenker i overskriftene til dokumentet gjør det også omfattende for deg.