Markdown lenke til seksjon

"Å gi koblinger som leder leseren til en bestemt del av dokumentet er en veldig gunstig og viktig teknikk for å spare tiden for brukeren. Denne teknikken sparer ikke bare brukere tid, men engasjerer også flere lesere på nettsiden. Markdown gjør oss i stand til å lage lenker som refererer til en bestemt del av det samme dokumentet bare ved å klikke på lenken.”

Denne guiden vil gjøre deg i stand til å generere slike lenker i dokumentet ditt.

Opprette lenker til bestemte deler av dokumentet i Markdown

I denne opplæringen vil vi se hvordan du oppretter en lenke til en bestemt del av det samme dokumentet i Markdown. Slik at du ved å klikke på lenken for den aktuelle delen, kan du enkelt få tilgang til den uten å måtte navigere gjennom hele dokumentet for å finne det.

Før vi begynner å jobbe med emnet, må vi først finne et verktøy med det aktuelle miljøet for å implementere Markdown -skriptet. Det finnes en rekke verktøy som støtter markdown -språket. I vårt tilfelle har vi funnet Visual Studio Code som den beste programvaren for å samle Markdown -skriptene. Derfor lastet vi ned programvaren og installerte den i systemet vårt. Når grensesnittet er lansert, oppretter du en ny fil og velger filtypen som "Markdown". Legg til "Markdown alt i en" -forlengelse i verktøyet, og trykk deretter på “Ctrl+Shift+V” -tastene for å åpne forhåndsvisningsvinduet. Forhåndsvisningsvinduet vil gjengi den forventede utdata fra skriptet skrevet i Markdown -filen.

Nå vil vi sette i gang ved å lære å lage en lenke i Markdown. Link -generasjon er en veldig enkel metode, som resten av markdown -konseptene. Syntaksen for å opprette en lenke i Markdown for en del av det samme dokumentet er gitt nedenfor:

Denne syntaksen har to deler. Den første delen har tittelen på lenken, og den andre delen lagrer lenken til den aktuelle delen. For å skrive tittelen på lenken, må vi bruke de firkantede parentesene “[]” og skrive hvilken etikett du vil at lenken din skal vises med. Koblingen til den spesifikke delen av dette dokumentet kan legges til ved å bruke de runde parentesene “()”. I parentesene, sett inn et hasj (#) -symbol, og skriv deretter navnet på den aktuelle delen slik du har tittelen det i dokumentet. Hvis tittelen du vil ha en lenke for har mellomrom i seg, vil du legge til streker (-) for å erstatte mellomrommene mens du legger den som en lenkereferanse.

La oss nå implementere det i VS -kode

Vi har opprettet en markdown -overskrift i filen vår. For å lage en overskrift, må vi bruke hasj (#) -symbolet og deretter sette et rom før vi skriver overskriftstittelen. Dette vil skape en overskrift med H1 -størrelse. Så vi har lagt til hasj (#), og etter plassen blir tittelen på overskriften identifisert som "seksjon 1". For å flytte til neste linje, må vi ganske enkelt trykke Enter. Her skal vi skrive et avsnitt. Markdown gir ingen spesiell syntaks for å skrive et avsnitt, du må bare skrive teksten, og den vil bli vist som et vanlig tekstavsnitt.

Vi har lagt til litt tekst for å lage et avsnitt under den første overskriften, som er "Vi lager lenker i Markdown for å få tilgang til en del av det samme dokumentet. Fortsett å følge trinnene for å lære konseptet.”Du kan se det i øyeblikksbildet av skriptet som er vedlagt nedenfor:

Tilsvarende det anvendte Markdown -skriptet, viser forhåndsvisningsvinduet en overskrift med H1 -størrelse med tittelen “Avsnitt 1”, og under det er et avsnitt gjengitt.

Nå for å opprette en Markdown -kobling for å bla til denne delen av dokumentet, vil vi utøve Markdown Link Syntax spesifisert ovenfor.

Du kan legge til lenken hvor som helst i dokumentet som best passer dine krav. For vår illustrasjon genererer vi en lenke øverst på siden, slik at hvis brukeren vil hoppe til en bestemt overskrift, vil lenken ta ham/henne der i stedet for å navigere gjennom hele dokumentet.

Så vi startet prosessen ved først å legge til den normale teksten som "klikk", og så startet vi firkantede parenteser. Mellom disse seler er tittelen for lenken spesifisert. Vi har lagt til link -etiketten som "seksjon1". Rett etter de firkantede parentesene uten plass, har vi satt inn de runde parentesene. Her vil vi legge til referansen til overskriften som skal åpnes når vi klikker på lenken. Først, legg til hash (#) -symbolet og skriv deretter den spesifikke overskriftenes tittel. Siden navnet på overskriften, som er "seksjon 1" i vårt tilfelle, har et rom, mens vi nevner overskriften på koblingsstedet, kan vi ikke legge til mellomrom. Så for å erstatte plassen, har vi satt inn dash (-) -symbolet mellom de to ordene som “#seksjon-1”.

Som vi har lagt til tekst før vi genererer en lenke, kan vi også legge den til etter lenken. Så vi skrev det som “Klikk [seksjon1] (#seksjon-1) for å åpne den første overskriften.”

I forhåndsvisningsvinduet kan du observere at strengen som vi har lagt til i firkantede parenteser, er vist i blå farge, som viser at dette er en lenke. Henvisningen til dokumentets seksjon vi har gitt er innebygd i denne strengen. Så når du klikker på den, tar det deg direkte til den delen av siden der overskriften er "Avsnitt 1".

Så når vi klikker på den, fører det oss til en bestemt del av dokumentet med en spesifisert overskrift.

Nå vil vi lage lenker for noen andre deler av dokumentet, men først må vi lage forskjellige overskrifter.

Under avsnittet til den første overskriften forlot vi en tom linje og begynte å skrive på linjen ved siden av. For å lage den andre overskriften, har vi brukt doble hasj (##), plass og overskriftstittelen som “Avsnitt 1.2 ”. Så la vi til et eksempler på avsnittet for denne overskriften.

For å legge til den tredje overskriften, har vi satt inn 3 hasj og med tittelen den “Avsnitt 3” og lagt også til et eksempel på avsnittet for det.

Så opprettet vi lenker for hver overskrift. For den andre overskriften skrev vi det som "Klikk for å åpne [seksjon 2] (#seksjon-2)," og for den tredje overskriften "Klikk for å åpne [seksjon 3] (#seksjon-3)". Vi har lagt til alle tre koblingene øverst i dokumentet.

Hvis du klikker på lenken "Seksjon 2", åpner den seksjon 2 -overskriften på toppen av siden.

Tilsvarende bringer klikk på lenken “Avsnitt 3” oss til den delen av siden som inneholder "seksjon 3" -overskriften. Som vist på bildet nedenfor:

Som en helhet ser vårt skapte dokument noe slik:

Konklusjon

Markdown gir oss forskjellige teknikker for å legge til lenker til dokumentene våre. Å sette inn lenker for rask tilgang til en bestemt del av siden er en av de beste praksisene for å lette brukeren. I denne artikkelen har vi utdypet dette konseptet med en veldig detaljert forklaring av Markdown -skriptet. Vi har opprettet eksempler på overskrifter og setter også avsnitt i dem. For hver overskrift ble koblinger generert. Vi har også gjengitt det forventede utfallet som ble generert i forhåndsvisningsvinduet for hver lenke vi klikket.