Tabla de contenido de Markdown
Creación de la tabla de contenido en Markdown:
Se puede crear una tabla de contenido en un documento utilizando la sintaxis de Markdown nativo. Este tutorial nos ayudará a aprender la generación de la tabla de contenido de Markdown.
Para la implementación práctica de los scripts de Markdown, necesitamos una herramienta que admita el lenguaje de Markdown. Hemos elegido el código de Visual Studio para la compilación de códigos de ejemplo. Después de iniciar la herramienta, creamos un nuevo archivo y establecimos su tipo en "Markdown."Para abrir la ventana de vista previa, simplemente presione las teclas" Ctrl+Shift+V ". Ahora tenemos un archivo "Markdown" y una ventana de vista previa correspondiente a él.
La herramienta para compilar el script está configurado ahora. La creación de la tabla de contenido comenzaría después. En el archivo de Markdown, primero creamos un encabezado. Para la creación de un encabezado, estamos obligados a agregar un símbolo hash (#). Agregar un solo hash (#) se refiere al encabezado del primer nivel. Después del símbolo hash, se debe dar un espacio antes de escribir el texto de su encabezado. El texto que hemos especificado para el encabezado de nuestro documento es "Tabla de contenido."Esto creará un encabezado con tamaño H1 en la parte superior de nuestra página web.
Luego saltamos algunas líneas antes de escribir el siguiente script. Ahora crearemos una lista de encabezados de contenido disponibles en el documento. Para crear una lista de Markdown, tenemos dos opciones: si crear listas ordenadas o listas desordenadas. Para la generación de listas, tenemos que escribir un valor numérico y agregar un punto (.) Inmediatamente después. Luego, después de un espacio, mencione los elementos de la lista. Para los elementos de la lista aquí, tenemos que crear enlaces de Markdown que nos dirijan a una sección específica del documento cuando hagamos clic en ellos.
Por lo tanto, agregamos el primer elemento de lista con el valor numérico "1" y luego para crear el enlace a una sección de la página, primero escribimos el título de encabezado dentro de los soportes cuadrados seguidos de aparatos ortopédicos que contendrán un hash (#) símbolo y el título del encabezado al que puede dirigir al usuario. No puede dar ninguna pestaña o espacio en los aparatos ortopédicos al agregar enlaces a parte del documento. En su lugar, puede usar guiones (-) donde sea necesario como reemplazo para espacios. Entonces, para el primer elemento de la lista, hemos agregado el enlace como "1. [Introducción] (#Introducción)."
El texto en el soporte cuadrado se mostrará tal como está y cuando hagamos clic, se desplazará a la parte del documento donde encontrará el mismo texto de encabezado que hemos proporcionado en los aparatos ortopédicos. El segundo elemento de la lista se adjunta como "2. [Tema 1] (#Tema-1)."Aquí," Tema 1 "se presentará tal como está y el"#Topic-1 "se integrará como un enlace de sección. El tercer elemento de la lista tiene el texto "3. [Tema 2] (#Tema-2)."Y el último artículo lo tiene como" 4. [Tema 3] (#Tema-3)."
Ahora crearíamos subtítulos con el mismo título que se menciona en el enlace de la sección de la lista. Para crear los subtítulos, tenemos que usar hashes dobles (##). Después de los símbolos, coloque un espacio y luego inscriba el título de encabezado, que debería ser el mismo que se define para el enlace en la lista anterior. Si agregamos un título diferente, el enlace no funcionará. Entonces, agregamos el primer subtítulo después de insertar los hash como "Introducción."Para los títulos segundo, tercero y cuarto, los títulos son" Tema 1 "," Tema 2 "y" Tema 3 "respectivamente.
La ventana de vista previa nos muestra el resultado anticipado correspondiente para este script de markdown, donde se genera una tabla de contenido con 4 elementos de la lista y sus encabezados de referencia se han mostrado debajo de ellos.
Todos estos son contenidos textuales. También podemos agregar un enlace externo como encabezado en la tabla de contenido. Seguiremos el mismo patrón que usamos en la creación de elementos de la lista anterior, excepto una cosa. Agregaremos un enlace al sitio web con el enlace de sección en los soportes redondos también. Para esto, primero hemos creado otro elemento de lista como "5. [Tema 4] (#Topic-5httpwwwyahoocom)."Puede ver que no hemos agregado ningún punto en el nombre del sitio web.
Ahora necesitamos crear un encabezado correspondiente a este enlace. Entonces, agregamos hashs y espacio dobles, y luego aquí no simplemente escribiremos el texto para el título; En su lugar, crearemos un enlace. Primero, escribiríamos el texto del enlace, que insertamos lo mismo que se especificó para el nuevo elemento de la lista "[Tema 5]."Luego insertamos soportes redondos inmediatamente después de los paréntesis de Square y escribimos el enlace completo del sitio web como" http: // www.yahoo.com ".
Esto agregará otro encabezado a la tabla de contenido, pero es un enlace, no solo un texto plano.
Puede ver que el último encabezado ha sido subrayado, lo que representa indica que es un enlace. Cuando hagamos clic en él, abrirá la dirección web especificada en el navegador. Aquí hemos proporcionado el "Yahoo.com ". Entonces, abrirá Yahoo en nuestro navegador.
Hemos generado con éxito nuestra tabla de contenido en Markdown, que tiene algunos encabezados y una lista. Ahora veremos cómo podemos agregar subtítulos a los encabezados principales de la lista.
De la lista de contenido que hemos generado anteriormente, hemos elegido los 2Dakota del Norte Elemento de la lista, que tiene el título "Tema 1". Para crear una lista de niños, tenemos que ingresar dos espacios en la línea al lado del elemento de la lista de padres. Después de dar los espacios, numeramos la lista como "1."Luego usamos los soportes cuadrados para especificar los títulos, seguidos inmediatamente por los soportes redondos para proporcionar un enlace a la parte específica del documento. Entonces, agregamos dos elementos de la lista de niños como "1. [Sub-topic 1] (#sub-topic-1) "y en la siguiente línea, el segundo elemento es" 2. [Sub-tope 2] (#sub-topic-2.) "
Luego, pasando a la parte del contenido del documento, hemos agregado dos nuevos subtítulos. Para crear subtidings con el nivel 3, tenemos que agregar 3 símbolos hash (#) seguidos de un espacio y el texto del subtítulo. Hemos especificado los mismos títulos que hemos mencionado para vincular las secciones en la lista. El primer subtítulo tiene el título "Sub-Tope 1" y el segundo es "Sub-Tope 2."
En la instantánea de la ventana de vista previa a continuación, puede ver que los subtítulos se han agregado con éxito a nuestra tabla de contenido de Markdown.
Conclusión
La tabla de contenido (TOC) se puede generar manualmente en un documento de Markdown. En esta guía, trabajamos en la capacidad de Markdown de permitir la generación de una tabla de contenido manualmente. Hemos ejecutado los fragmentos de código y elaboramos en toda la sintaxis utilizada y los pasos que deben llevarse a cabo. Aprendimos a hacer una tabla simple de contenido con una lista de markdown y encabezados. Además, la incrustación de enlaces externos en los encabezados del documento lo hace completo para usted.