Collegamento markdown alla sezione

“Fornire collegamenti che indirizzano il lettore a una particolare sezione del documento è una tecnica molto utile e importante per risparmiare il tempo dell'utente. Questa tecnica non solo risparmia il tempo degli utenti, ma coinvolge anche più lettori sulla pagina web. Markdown ci consente di creare collegamenti che si riferiscono a una sezione particolare dello stesso documento semplicemente facendo clic sul collegamento."

Questa guida ti renderà in grado di generare tali link nel tuo documento.

Creazione di collegamenti a sezioni particolari del documento in Markdown

In questo tutorial, vedremo come creare un collegamento a una particolare sezione dello stesso documento nel markdown. In modo che facendo clic sul collegamento per quella particolare sezione, puoi accedervi facilmente senza dover navigare attraverso l'intero documento per trovarlo.

Prima di iniziare a lavorare sull'argomento, in primo luogo, dobbiamo trovare uno strumento con l'ambiente appropriato per implementare lo script Markdown. Ci sono una varietà di strumenti che supportano la lingua di markdown. Nel nostro caso, abbiamo trovato il codice Visual Studio come il miglior software per la compilazione degli script di Markdown. Quindi, abbiamo scaricato il software e installato nel nostro sistema. Una volta avviata l'interfaccia, crea un nuovo file e seleziona il tipo di file come "markdown". Aggiungi l'estensione "Markdown All in One" nello strumento e quindi premere i tasti "CTRL+SHIFT+V" per aprire la finestra di anteprima. La finestra di anteprima renderà l'output previsto dello script scritto nel file Markdown.

Ora inizieremo imparando a creare un link in markdown. La generazione di collegamenti è un metodo molto semplice, come il resto dei concetti di markdown. La sintassi per creare un collegamento in markdown per una sezione dello stesso documento è fornita di seguito:

Questa sintassi ha due parti. La prima parte detiene il titolo del collegamento e la seconda porzione memorizza il collegamento della sezione particolare. Per scrivere il titolo del link, dobbiamo usare le staffe quadrate "[]" e scrivere qualsiasi etichetta tu voglia che il tuo link venga mostrato. Il collegamento alla sezione specifica di quel documento può essere aggiunto utilizzando le staffe rotonde "()". All'interno delle parentesi, inserisci un simbolo hash (#), quindi scrivi il nome della sezione particolare come lo hai intitolato nel documento. Se il titolo per cui si desidera un link ha spazi, allora aggiungeresti trattini (-) per sostituire gli spazi mentre lo metti come riferimento a collegamento.

Ora lo implementiamo in codice VS

Abbiamo creato un markdown intestazione nel nostro file. Per creare un titolo, dobbiamo usare il simbolo hash (#) e quindi mettere uno spazio prima di scrivere il titolo di intestazione. Questo creerà un'intestazione con la dimensione H1. Quindi, abbiamo aggiunto l'hash (#) e dopo lo spazio, il titolo dell'intestazione è identificato come "Sezione 1". Per passare alla riga successiva, dobbiamo semplicemente premere Invio. Qui scriveremo un paragrafo. Markdown non fornisce alcuna sintassi speciale per la scrittura di un paragrafo, devi solo scrivere il testo e verrà mostrato come un normale paragrafo di testo.

Abbiamo aggiunto un po 'di testo per la creazione di un paragrafo sotto la prima intestazione, che è “Stiamo creando collegamenti in markdown per accedere a una sezione dello stesso documento. Continua a seguire i passaggi per imparare il concetto."Puoi vederlo nell'istantanea dello script allegato di seguito:

Corrispondente allo script markdown applicato, la finestra di anteprima visualizza un'intestazione con dimensioni H1 intitolata "Sezione 1" e sotto di essa, viene reso un paragrafo.

Ora per creare un collegamento a markdown per scorrere su questa sezione del documento, eserciteremo la sintassi del collegamento a markdown specificato sopra.

Puoi aggiungere il link ovunque nel documento che si adatta meglio alle tue esigenze. Per la nostra illustrazione, stiamo generando un link nella parte superiore della pagina in modo che se l'utente desidera passare a una violazione specifica, il link lo porterà lì invece di navigare attraverso l'intero documento.

Quindi, abbiamo iniziato il processo aggiungendo prima il testo normale come "clic", e poi abbiamo iniziato le staffe quadrate. Tra queste parentesi graffe, è specificato il titolo per il collegamento. Abbiamo aggiunto l'etichetta del collegamento come "Sezione1". Subito dopo le staffe quadrate senza spazio, abbiamo inserito le parentesi rotonde. Qui aggiungeremo il riferimento dell'intestazione da aprire quando facciamo clic sul collegamento. Innanzitutto, aggiungi il simbolo hash (#) e poi scrivi il titolo di intestazione specifica. Poiché il nome dell'intestazione, che è "Sezione 1" in nostro istanza, ha uno spazio, pur menzionando l'intestazione nel luogo di collegamento, non possiamo aggiungere spazi. Quindi, per sostituire lo spazio, abbiamo inserito il simbolo trattino (-) tra le due parole come "#sezione-1".

Dato che abbiamo aggiunto il testo prima di generare un link, possiamo anche aggiungerlo dopo il collegamento. Quindi l'abbiamo scritto come “Fare clic su [sezione1] (#sezione 1) per aprire la prima intestazione."

Nella finestra di anteprima, è possibile osservare che la stringa che abbiamo aggiunto tra parentesi quadrate è mostrata in colore blu, il che descrive che questo è un collegamento. Il riferimento alla sezione del documento che abbiamo fornito è incorporato in questa stringa. Quindi, quando fai clic su di esso, ti porterà direttamente alla parte della pagina in cui l'intestazione è "Sezione 1".

Quindi, quando facciamo clic su di esso, ci porta a una particolare sezione del documento con un'intestazione specificata.

Ora creeremo collegamenti per alcune altre sezioni del documento, ma in primo luogo, dobbiamo creare titoli diversi.

Sotto il paragrafo della prima intestazione, abbiamo lasciato una linea vuota e abbiamo iniziato a scrivere sulla linea accanto ad essa. Per la creazione della seconda intestazione, abbiamo usato doppi hash (##), spazio e titolo di intestazione come “Sottosezione 1.2 ". Quindi abbiamo aggiunto un paragrafo di esempio per questa intestazione.

Per l'aggiunta della terza intestazione, abbiamo inserito 3 hash e intitolato "Sezione 3", e abbiamo aggiunto un paragrafo di esempio anche per esso.

Quindi abbiamo creato collegamenti per ogni intestazione. Per la seconda intestazione, l'abbiamo scritto come "Fai clic per aprire [sezione 2] (#sezione 2)" e per la terza intestazione, "Fai clic per aprire [sezione 3] (#sezione 3)". Abbiamo aggiunto tutti e tre i collegamenti nella parte superiore del documento.

Se si fa clic sul collegamento "Sezione 2", aprirà la sezione 2 in cima alla pagina.

Allo stesso modo, facendo clic sul collegamento "Sezione 3" ci porta alla parte della pagina contenente l'intestazione "Sezione 3". Come visualizzato nell'immagine qui sotto:

Nel complesso, il nostro documento creato assomiglia a questo:

Conclusione

Markdown ci fornisce diverse tecniche per aggiungere collegamenti ai nostri documenti. L'inserimento di collegamenti per un rapido accesso a una parte particolare della pagina è una delle migliori pratiche per facilitare l'utente. In questo articolo, abbiamo elaborato questo concetto con una spiegazione molto dettagliata della sceneggiatura di Markdown. Abbiamo creato intestazioni di esempio e anche messo i paragrafi. Per ogni intestazione, sono stati generati collegamenti. Abbiamo anche reso il risultato previsto generato nella finestra di anteprima per ogni link che abbiamo fatto clic su.