Tabela de conteúdo de marcação

Um índice é uma lista de títulos para os capítulos ou seções de um documento, organizados de acordo com sua sequência de aparência. No Markdown, você pode criar um índice manualmente ou gerar um automaticamente. Para esta lição, praticaremos a construção de Markdown TOC manualmente usando a sintaxe do script nativo de Markdown.

Criando o índice em Markdown:

Uma tabela de conteúdo pode ser criada em um documento usando a sintaxe de Markdown nativa. Este tutorial nos ajudará a aprender a geração da tabela de conteúdo de marcação.

Para a implementação prática dos scripts de Marydown, precisamos de uma ferramenta que suporta o idioma de marcação. Escolhemos o código do Visual Studio para a compilação de códigos de exemplo. Depois de lançar a ferramenta, criamos um novo arquivo e definimos seu tipo como “Markdown.”Para abrir a janela de visualização, basta pressionar as teclas“ Ctrl+Shift+V ”. Agora temos um arquivo "Markdown" e uma janela de visualização correspondente a ele.

A ferramenta para compilar o script está definida agora. A criação da tabela de conteúdo começaria depois. No arquivo de rekdown, criamos um cabeçalho pela primeira vez. Para a criação de um cabeçalho, somos obrigados a adicionar um símbolo de hash (#). Adicionando um único hash (#) refere -se ao título de primeiro nível. Após o símbolo de hash, um espaço deve ser dado antes de escrever o texto do seu cabeçalho. O texto que especificamos para o cabeçalho do nosso documento é “Índice.”Isso criará um título com o tamanho H1 no topo de nossa página da web.

Então pulamos algumas linhas antes de escrever o próximo script. Agora criaremos uma lista de títulos de conteúdo disponíveis no documento. Para criar uma lista de remarcar, temos duas opções: se devemos criar listas ordenadas ou listas não ordenadas. Para a geração de listas, temos que escrever um valor numérico e adicionar um ponto (.) imediatamente depois disso. Então, depois de um espaço, mencione os itens da lista. Para os itens da lista aqui, temos que criar links de marcação que nos direcionarão para uma seção específica do documento quando clicarmos neles.

Então, adicionamos o primeiro item da lista com o valor numérico "1" e, em seguida, para criar o link para uma seção da página, primeiro escrevemos o título do título dentro dos suportes quadrados, seguido de aparelhos redondos que manterão um hash (#) símbolo e o título do cabeçalho para o qual pode direcionar o usuário. Você não pode dar nenhuma guia ou espaço nos aparelhos redondos ao adicionar links para parte do documento. Em vez disso, você pode usar traços (-) sempre que necessário como substituto para espaços. Então, para o primeiro item da lista, adicionamos o link como “1. [Introdução] (#Introdução).”

O texto no suporte quadrado será exibido como é e, quando clicarmos nele, ele rolará para a parte do documento, onde encontrará o mesmo texto de título que fornecemos no aparelho redondo. O segundo item da lista é anexado como “2. [Tópico 1] (#tópico-1).”Aqui,“ Tópico 1 ”será renderizado como está e o“#tópico-1 ”será incorporado como um link de seção. O terceiro item da lista tem o texto “3. [Tópico 2] (#tópico-2).”E o último item tem como“ 4. [Tópico 3] (#Tópico 3).”

Agora criaríamos subtítulos com o mesmo título mencionado no link da seção da lista. Para criar as subtítulos, temos que usar hashes duplos (##). Após os símbolos, coloque um espaço e depois inscreva o título do título, que deve ser o mesmo definido para o link na lista acima. Se adicionarmos um título diferente, o link não funcionará. Então, adicionamos a primeira subposição depois de inserir os hashes como “introdução.”Para os títulos do segundo, terceiro e quarto, os títulos são“ Tópico 1 ”,“ Tópico 2 ”e“ Tópico 3 ”, respectivamente, respectivamente.

A janela de visualização nos mostra o resultado previsto correspondente para este script de marcação, onde um índice é gerado com 4 itens de lista e seus títulos de referência foram exibidos abaixo deles.

Todos esses são conteúdos textuais. Também podemos adicionar um link externo como título na tabela de conteúdo. Seguiremos o mesmo padrão que usamos na criação de itens de lista anterior, exceto por uma coisa. Adicionaremos um link ao site com o link da seção nos colchetes também. Para isso, criamos primeiro outro item de lista como “5. [Tópico 4] (#tópico-5httpwwwyahoocom).”Você pode ver que não adicionamos nenhum ponto no nome do site.

Agora precisamos criar um título correspondente a este link. Então, adicionamos hashes e espaço duplos e aqui não vamos simplesmente escrever o texto para o título; Em vez disso, criaremos um link. Primeiro, escrevemos o texto do link, que inserimos o mesmo especificado para o novo item da lista “[Tópico 5].”Então inserimos suportes redondos imediatamente após os parênteses quadrados e escrevemos o link completo do site como“ http: // www.Yahoo.com ”.

Isso adicionará outro cabeçalho ao índice, mas é um link, não apenas um texto simples.

Você pode ver que o último cabeçalho foi sublinhado, o que representa indica que é um link. Quando clicarmos nele, ele abrirá o endereço da web especificado no navegador. Aqui nós fornecemos o “Yahoo.com ”. Então, ele abrirá o Yahoo em nosso navegador.

Geramos com sucesso nosso índice em Markdown, que tem alguns títulos e uma lista. Agora veremos como podemos adicionar subtítulos aos títulos principais da lista.

Na lista de conteúdo que geramos anteriormente, escolhemos os 2^nd Item da lista, que tem o título "Tópico 1". Para criar uma lista infantil, temos que inserir dois espaços na linha ao lado do item da lista pai. Depois de dar os espaços, numeramos a lista como “1.”Depois, usamos os colchetes para especificar os títulos, seguidos imediatamente por suportes redondos para fornecer um link para a parte específica do documento. Então, adicionamos dois itens da lista de crianças como “1. [Sub-tópico 1] (#sub-tópico-1) ”e na próxima linha, o segundo item é“ 2. [Sub-tópico 2] (#sub-tópico-2.) ”

Em seguida, mudando para a parte do conteúdo do documento, adicionamos dois novos sub-cabeças. Para criar subtítulos com o nível 3, precisamos adicionar 3 símbolos de hash (#) seguidos por um espaço e o texto da sub-título. Especificamos os mesmos títulos que mencionamos para vincular as seções da lista. A primeira subposição tem o título "Sub-tópico 1" e o segundo é "Sub-tópico 2.”

No instantâneo da janela de pré -visualização abaixo, você pode ver que as subtítulos foram anexadas com sucesso ao nosso índice de remarca.

Conclusão

O índice (TOC) pode ser gerado manualmente em um documento de remarca. Neste guia, trabalhamos na capacidade do Markdown de permitir a geração de um índice manualmente. Executamos os trechos de código e elaboramos em toda a sintaxe usada e etapas que precisam ser realizadas. Aprendemos a fazer um índice simples com uma lista de remarca e títulos. Além disso, incorporar links externos nos títulos do documento o torna abrangente para você.