Markdown es un lenguaje open source de escritura, originalmente implementado en Perl para convertir texto plano a HTML. Actualmente lo soportan cantidad de lenguajes de programación, incluyendo PHP, Python, Ruby, Java y Common Lisp y se utiliza en muchas webs como GitHub, Reddit o WordPress, entre otras muchas.

Hace algunos años que lo utilizo cuando escribo para web, e incluso para algún escrito que vaya a convertir en pdf, ya que utiliza una sintaxis muy sencilla. Su propósito es ser fácil de leer y escribir. Pero como todo, tiene sus “problemillas”. Por ejemplo, realizar un índice. En principio en su sintaxis no se contempla, pero como hay gente muy lista por el mundo, hay soluciones para todo.

En stackoverflow encontré la forma de realizar un índice para un texto escrito en Markdown. Bueno, en realidad dos formas.

La primera opción es utilizando la etiqueta <a name> del lenguaje HTML que crea un enlace entre un elemento del índice y otro en el cuerpo del texto:

**Índice**   
1. [Primer apartado](#id1)
2. [Segundo apartado](#id2)
## Primer apartado<a name="id1"></a>
Texto del primer apartado
## Segundo apartado<a name="id2"></a>
Texto del segundo apartado

Obtenemos como resultado:

Índice
1. Primer apartado
2. Segundo apartado

Primer apartado

Texto del primer apartado

Segundo apartado

Texto del segundo apartado


La segunda opción es muy parecida ya que utilizamos también HTML, pero utilizando la etiqueta div que se utiliza para dar un determinado atributo o valor a una sección del código.

El formato sería:

**Índice**
1. [Primer apartado](#id1)
2. [Segundo apartado](#id2)
<div id='id1' />
## Primer apartado
Texto del primer apartado
<div id='id2' />
## Segundo apartado
Texto del segundo apartado

Como resultado obtendríamos:

Índice
1. Primer apartado
2. Segundo apartado

Primer apartado

Texto del primer apartado

Segundo apartado

Texto del segundo apartado


¿Qué os parece? ¿Conocéis algún otro método?

Fuente: stackoverflow

Anuncios