Guía para crear una tabla de contenidos en Markdown

Las tablas de contenido son una adición muy útil para publicaciones con mucho contenido, ya que permite navegar por secciones en la misma página con sólo un clic. Es muy fácil añadirlas en Markdown para publicaciones como la que lees ahora mismo; existen diferentes maneras de hacerlo, pero aquí aprenderás a crearlas en un formato que funciona en cualquier editor de Markdown. A continuación se mostrará el formato de la tabla de contenidos y se explicará en la siguiente sección: Formato de la tabla de contenidos Tabla de contenidos <!-- Aquí se escribe la tabla de contenido --> Sección 1 Sub-sección 1 Sub-sección 2 Sección 2 <!-- Aquí se escriben las secciones a las cuales se redirigirá --> Sección 1 <a name="sección1"></a> Texto de la sección 1. Sub-sección 1 <a name="sub-sección1-1"></a> Texto de la sub-sección 1. Sub-sección 2 <a name="sub-sección1-2"></a> Texto de la sub-sección 2. Sección 2 <a name="sección2"></a> Texto de la sección 2. Explicación del formato Primero debemos escribir la tabla de contenido como tal, la cual cuenta únicamente con tres elementos: Número de la sección: 1. Se usa una lista en Markdown para este propósito, la cual es creada escribiendo números seguidos de un punto ( . ). Para crear una sub-sección se deben colocar tres espacios detrás del número, como se muestra en el formato. Nombre de la sección: Sección 1 Es el nombre que será visible por el usuario y en el cual podrá hacer clic para ser redirigido a la sección. Aquí se suele colocar el título de la sección. Código del enlace: (#sección1) El código es la parte más importante de la tabla de contenidos, funciona para enlazar el texto con la sección al hacer clic sobre el nombre. Su objetivo es ayudar al creador de la publicación a identificar las secciones; este texto no es visible al usuario, siempre debe contener la almohadilla ( # ) y no puede contener espacios, porque perdería el formato. Luego debemos vincular esos enlaces con las secciones, lo cual se hace simplemente con un solo elemento: Código de la sección: Este código se coloca justo después del texto al cual se quiere redirigir, y lo único que se debe cambiar es lo que se encuentra dentro de las comillas ( "" ) para que coincida con el título de la tabla de contenidos; por ejemplo, (#paleta_de_colores) siempre llevará al lugar donde se escribió Flexibilidad del formato Este formato no sólo es útil para crear tablas de contenido, al poder llevarte a cualquier lugar dentro de la página actual se puede usar para otros propósitos, como el de dirigirte a una imagen en concreto de la página, como la que se encuentra al principio de esta publicación, por ejemplo.