Link de marcação para a seção

“Fornecer links que direcionam o leitor a uma seção específica do documento é uma técnica muito benéfica e importante para salvar o tempo do usuário. Essa técnica não apenas economiza tempo aos usuários, mas também envolve mais leitores na página da web. Markdown nos permite criar links que se referem a uma seção específica do mesmo documento, clicando no link.”

Este guia o tornará capaz de gerar esses links em seu documento.

Criando links para seções específicas do documento em Markdown

Neste tutorial, veremos como criar um link para uma seção específica do mesmo documento no Markdown. Para que, ao clicar no link para essa seção em particular, você pode acessá -lo facilmente sem precisar navegar por todo o documento para encontrá -lo.

Antes de começarmos a trabalhar no assunto, primeiro, precisamos encontrar uma ferramenta com o ambiente apropriado para implementar o script de marcação. Há uma variedade de ferramentas que suportam o idioma de marcação. No nosso caso, encontramos o Código do Visual Studio como o melhor software para compilar os scripts de Markdown. Por isso, baixamos o software e o instalamos em nosso sistema. Depois que a interface for iniciada, crie um novo arquivo e selecione o tipo de arquivo como "Markdown". Adicione a extensão "Markdown All in One" na ferramenta e pressione as teclas "Ctrl+Shift+V" para abrir a janela de visualização. A janela de pré -visualização renderizará a saída prevista do script escrito no arquivo de marcação.

Agora iniciaremos aprendendo a criar um link no Markdown. A geração de links é um método muito fácil, como o restante dos conceitos de marcação. A sintaxe para criar um link no Markdown para uma seção do mesmo documento é fornecida abaixo:

Esta sintaxe tem duas partes. A primeira parte mantém o título do link e a segunda parte armazena o link da seção específica. Para escrever o título do link, temos que usar os colchetes "[]" e escrever qualquer rótulo que você deseja que seu link seja mostrado. O link para a seção específica desse documento pode ser adicionado usando os colchetes redondos “()”. Dentro dos parênteses, insira um símbolo de hash (#) e, em seguida, escreva o nome da seção específica, como você o intitulou no documento. Se o título para o qual você deseja um link tem espaços, você adicionaria traços (-) para substituir os espaços enquanto o coloca como uma referência de link.

Agora vamos implementá -lo no código VS

Nós criamos um título de remarca em nosso arquivo. Para criar um título, temos que usar o símbolo Hash (#) e depois colocar um espaço antes de escrever o título do título. Isso criará um título com tamanho H1. Então, adicionamos o hash (#) e, após o espaço, o título do cabeçalho é identificado como "Seção 1". Para mudar para a próxima linha, simplesmente temos que pressionar Enter. Aqui vamos escrever um parágrafo. Markdown não fornece nenhuma sintaxe especial para escrever um parágrafo, você só precisa escrever o texto e será mostrado como um parágrafo regular de texto.

Adicionamos algum texto para criar um parágrafo sob o primeiro título, que é “Estamos criando links no Markdown para acessar alguma seção do mesmo documento. Continue seguindo as etapas para aprender o conceito.”Você pode vê -lo no instantâneo do script anexado abaixo:

Correspondente ao script de marcação aplicada, a janela de visualização exibe um cabeçalho com tamanho H1 intitulado “Seção 1” e abaixo dele, um parágrafo é renderizado.

Agora, para criar um link de marcação para rolar para esta seção do documento, exerceremos a sintaxe do link de marcação especificado acima.

Você pode adicionar o link em qualquer lugar do documento que melhor se adapte aos seus requisitos. Para nossa ilustração, estamos gerando um link na parte superior da página, para que, se o usuário quiser pular para um título específico, o link o levará até lá em vez de navegar por todo o documento.

Então, iniciamos o processo adicionando primeiro o texto normal como "clique" e depois iniciamos os colchetes quadrados. Entre esses aparelhos, o título do link é especificado. Adicionamos o rótulo do link como "seção1". Logo após os colchetes sem espaço, inserimos os parênteses redondos. Aqui vamos adicionar a referência do cabeçalho a ser aberta quando clicarmos no link. Primeiro, adicione o símbolo Hash (#) e depois escreva o título do cabeçalho específico. Como o nome do cabeçalho, que é "Seção 1" em nosso caso, tem um espaço, enquanto menciona o título no local do link, não podemos adicionar espaços. Então, para substituir o espaço, inserimos o símbolo do painel (-) entre as duas palavras como "#seção 1".

Como adicionamos texto antes de gerar um link, também podemos adicioná -lo após o link. Então, nós o escrevemos como “Clique em [Seção 1] (#Seção 1) para abrir o primeiro cabeçalho.”

Na janela de visualização, você pode observar que a corda que adicionamos entre os colchetes é mostrada na cor azul, o que mostra que este é um link. A referência à seção do documento que fornecemos está incorporada nesta string. Então, quando você clicar nele, ele o levará diretamente à parte da página em que o título é "Seção 1".

Então, quando clicamos nele, isso nos leva a uma seção específica do documento com um cabeçalho especificado.

Agora, criaremos links para algumas outras seções do documento, mas primeiro, temos que criar títulos diferentes.

Abaixo do parágrafo do primeiro título, deixamos uma linha em branco e começamos a escrever na linha ao lado. Para criar o segundo cabeçalho, usamos hashes duplos (##), espaço e o título do título como “Subseção 1.2 ”. Em seguida, adicionamos um parágrafo de amostra para este título.

Para adicionar o terceiro título, inserimos 3 hashes e o intitulamos “Seção 3” e anexamos um parágrafo de amostra para ele também.

Então criamos links para cada cabeçalho. Para o segundo título, escrevemos como "Clique para abrir [Seção 2] (#Seção 2)" e, para o terceiro título, "Clique para abrir [Seção 3] (#Seção 3)". Adicionamos todos os três links no topo do documento.

Se você clicar no link "Seção 2", ele abrirá o cabeçalho da Seção 2 em cima da página.

Da mesma forma, clicar no link “Seção 3” nos leva à parte da página que contém o título “Seção 3”. Conforme exibido na imagem abaixo:

Como um todo, nosso documento criado se parece com o seguinte:

Conclusão

Markdown nos fornece técnicas diferentes para adicionar links aos nossos documentos. Inserir links para acesso rápido a uma parte específica da página é uma das melhores práticas para facilitar o usuário. Neste artigo, elaboramos esse conceito com uma explicação muito detalhada do script de marcação. Criamos títulos de amostra e também colocamos parágrafos neles. Para cada cabeçalho, os links foram gerados. Também renderizamos o resultado previsto gerado na janela de visualização para cada link que clicamos.