Markdown Link do sekcji

„Dostarczanie linków, które kierują czytelnika do konkretnej sekcji dokumentu, jest bardzo korzystną i ważną techniką, aby zaoszczędzić czas użytkownika. Ta technika nie tylko oszczędza czas użytkowników, ale także angażuje więcej czytelników na stronie internetowej. Markdown umożliwia nam tworzenie linków, które odnoszą się do określonej sekcji tego samego dokumentu, klikając link."

Ten przewodnik sprawi, że będziesz w stanie generować takie linki w dokumencie.

Tworzenie linków do poszczególnych sekcji dokumentu w Markdown

W tym samouczku zobaczymy, jak utworzyć link do konkretnej sekcji tego samego dokumentu w Markdown. Tak, aby klikając link do tej konkretnej sekcji, możesz łatwo uzyskać do niego dostęp bez konieczności nawigacji przez cały dokument, aby go znaleźć.

Zanim zaczniemy pracować nad tematem, najpierw musimy znaleźć narzędzie z odpowiednim środowiskiem, aby wdrożyć skrypt Markdown. Istnieje wiele narzędzi, które wspierają język znaczników. W naszym przypadku znaleźliśmy kod Visual Studio jako najlepsze oprogramowanie do kompilacji skryptów Markdown. Stąd pobraliśmy oprogramowanie i zainstalowaliśmy je w naszym systemie. Po uruchomieniu interfejsu utwórz nowy plik i wybierz typ pliku jako „Markdown”. Dodaj rozszerzenie „Markdown All in One” do narzędzia, a następnie naciśnij klawisze „Ctrl+Shift+V”, aby otworzyć okno podglądu. Okno podglądu uczyni oczekiwane dane wyjściowe skryptu zapisane w pliku Markdown.

Teraz zainicjujemy, ucząc się tworzyć link w Markdown. Generowanie linków jest bardzo łatwą metodą, taką jak reszta koncepcji Markdown. Składnia do utworzenia linku w Markdown dla sekcji tego samego dokumentu znajduje się poniżej:

Ta składnia ma dwie części. Pierwsza część zawiera tytuł linku, a druga część przechowuje link konkretnej sekcji. Aby napisać tytuł linku, musimy użyć nawiasów kwadratowych „[]” i napisać dowolną etykietę, którą chcesz, aby Twój link był pokazany. Link do konkretnej sekcji tego dokumentu można dodać za pomocą okrągłych nawiasów „()”. W nawiasach wstawiaj symbol hash (#), a następnie napisz nazwę konkretnej sekcji, jak to zatytułowałeś w dokumencie. Jeśli tytuł chcesz, aby link do ma spacje, wówczas dodasz paski (-), aby wymienić przestrzenie, jednocześnie stawiając je jako link.

Teraz zaimplementujmy to w kodzie VS

Stworzyliśmy nagłówek Markdown w naszym pliku. Aby utworzyć nagłówek, musimy użyć symbolu hash (#), a następnie umieścić przestrzeń przed napisaniem tytułu nagłówka. To stworzy nagłówek z rozmiarem H1. Dodaliśmy więc skrót (#), a po przestrzeni tytuł nagłówka jest identyfikowany jako „Sekcja 1”. Aby przejść do następnego wiersza, musimy po prostu nacisnąć Enter. Tutaj napiszemy akapit. Markdown nie zawiera żadnej specjalnej składni do napisania akapitu, wystarczy napisać tekst, a zostanie wyświetlony jako zwykły akapit tekstowy.

Dodaliśmy trochę tekstu do utworzenia akapitu w ramach pierwszego nagłówka, czyli: „Tworzymy linki w Markdown, aby uzyskać dostęp do niektórych sekcji tego samego dokumentu. Kontynuuj postępowanie, aby poznać koncepcję.„Możesz to zobaczyć w migawce skryptu dołączonego poniżej:

Odpowiadające zastosowanemu skryptowi Markdown okno podglądu wyświetla nagłówek z rozmiarem H1 zatytułowanym „Sekcja 1”, a pod nim renderowany jest akapit.

Teraz, aby utworzyć link Markdown do przewijania do tej sekcji dokumentu, skorzystamy z składni Link Markdown określonej powyżej.

Możesz dodać link w dowolnym miejscu w dokumencie, który najlepiej odpowiada Twoim wymaganiom. W przypadku naszej ilustracji generujemy link u góry strony, aby jeśli użytkownik chce wskoczyć na konkretne nagłówek, link zabierze go tam/jej, zamiast przeglądać cały dokument.

Rozpoczęliśmy więc ten proces, najpierw dodając normalny tekst jako „kliknij”, a następnie rozpoczęliśmy kwadratowe nawiasy. Pomiędzy tymi aparatami do użytku podano tytuł linku. Dodaliśmy etykietę linku jako „Sekcja 1”. Zaraz po kwadratowych nawiasach bez miejsca, włożyliśmy okrągłe nawiasy. Tutaj dodamy odniesienie do nagłówka do otwarcia się po kliknięciu linku. Najpierw dodaj symbol skrótu (#), a następnie napisz tytuł konkretnego nagłówka. Ponieważ nazwa nagłówka, która jest „sekcją 1” w naszym przypadku, ma przestrzeń, jednocześnie wspominając nagłówek w miejscu łącza, nie możemy dodawać spacji. Aby zastąpić przestrzeń, wstawiliśmy symbol Dash (-) między dwoma słowami jako „#sekcja 1”.

Jak dodaliśmy tekst przed wygenerowaniem linku, możemy go również dodać po linku. Napisaliśmy więc jako „kliknij [sekcja 1] (#sekcja 1), aby otworzyć pierwszy nagłówek."

W oknie podglądu możesz zauważyć, że ciąg, który dodaliśmy do kwadratowych nawiasów, jest pokazany w kolorze niebieskim, co pokazuje, że jest to link. Odniesienie do sekcji dokumentu, który podaliśmy, jest osadzone w tym ciągu. Tak więc, kiedy go klikniesz, zabierze Cię bezpośrednio do części strony, w której nagłówek jest „Sekcja 1”.

Tak więc, kiedy go klikniemy, prowadzi nas do konkretnej sekcji dokumentu z określonym nagłówkiem.

Teraz utworzymy linki dla niektórych innych sekcji dokumentu, ale najpierw musimy utworzyć różne nagłówki.

Pod akapitem pierwszego nagłówka zostawiliśmy pustą linię i zaczęliśmy pisać na linii obok niego. Do stworzenia drugiego nagłówka użyliśmy podwójnych skrótów (##), przestrzeni i tytułu nagłówka jako „Podsekcja 1.2 ”. Następnie dodaliśmy przykładowy akapit do tego nagłówka.

Aby dodać trzeci nagłówek, włożyliśmy 3 skróty i zatytułowaliśmy go „Sekcja 3”, a także dołączyliśmy do tego przykładowy akapit.

Następnie utworzyliśmy linki dla każdego nagłówka. W przypadku drugiego nagłówka napisaliśmy to jako „kliknij, aby otworzyć [Sekcja 2] (#SEKCJA 2)”, a dla trzeciego nagłówka „Kliknij, aby otworzyć [Sekcja 3] (#SEKCJA-3)”. Dodaliśmy wszystkie trzy linki u góry dokumentu.

Jeśli klikniesz link „Sekcja 2”, otworzy on sekcję 2 na szczycie strony.

Podobnie kliknięcie linku „Sekcja 3” przenosi nas do części strony zawierającej nagłówek „Sekcja 3”. Jak pokazano na poniższym obrazku:

Jako całość nasz utworzony dokument wygląda tak mniej więcej tak:

Wniosek

Markdown zapewnia nam różne techniki dodawania linków do naszych dokumentów. Wstawienie linków do szybkiego dostępu do określonej części strony jest jedną z najlepszych praktyk ułatwiających użytkownikowi. W tym artykule opracowaliśmy tę koncepcję z bardzo szczegółowym wyjaśnieniem skryptu Markdown. Stworzyliśmy przykładowe nagłówki, a także włożyliśmy w nich akapity. Dla każdego nagłówka wygenerowano linki. Renderowaliśmy również oczekiwany wynik wygenerowany w oknie podglądu dla każdego kliknego linku.