Markdown es un lenguaje de marcado que facilita la aplicación de formato a un texto empleando una serie de caracteres de una forma especial

Introducción

En principio, Markdown fue pensado para elaborar textos cuyo destino iba a ser la web con más rapidez y sencillez que si estuviésemos empleando directamente HTML.

Cuando creas un archivo con formato Markdown, agregas sintaxis Markdown al texto para indicar qué palabras y frases deben verse diferentes.

Por ejemplo, para indicar un encabezado, se agrega un signo de número antes de él (por ejemplo: # Heading One).

O para poner una frase en negrita, se agregan dos asteriscos antes y después de ella (por ejemplo: **this text is bold**).

Entorno de trabajo

Crea un nuevo proyecto en Gitlab.

Crea un fichero hello.md con VS Code (o Idea).

Añade este texto:

# Hello

William Shakespeare Books:

* Romeo and Juliet
* King Lear
* Othello

Puedes visualizar el texto con "Preview":

Sintaxis básica

Todas las aplicaciones Markdown admiten la sintaxis básica descrita en el documento de diseño original de Markdown.

Encabezados

Para crear un encabezado, agrega el carácter numeral (#) antes de una palabra o frase.

El número de carácteres numerales se corresponde al nivel del encabezado.

Por ejemplo, para crear un encabezado de nivel tres (<h3>), utiliza tres signos numerales

### My Header

Recuerda:

  • Coloca siempre un espacio entre el carácter numeral y el nombre del encabezado.
  • Colocar líneas en blanco antes y después de un encabezado.
Markdown HTML Rendered Output
# Heading level 1 <h1>Heading level 1</h1>

Heading level 1
## Heading level 2 <h2>Heading level 2</h2>

Heading level 2
### Heading level 3 <h3>Heading level 3</h3>

Heading level 3
#### Heading level 4 <h4>Heading level 4</h4>

Heading level 4
##### Heading level 5 <h5>Heading level 5</h5>
Heading level 5
###### Heading level 6 <h6>Heading level 6</h6>
Heading level 6

Párrafos

Para crear párrafos, utiliza una línea en blanco para separar una o más líneas de texto:

Markdown HTML Rendered Output
I really like using Markdown.

I think I'll use it to format all of my documents from now on. 		<p>I really like using Markdown.</p>

<p>I think I'll use it to format all of my documents from now on.</p>

I really like using Markdown.

I think I'll use it to format all of my documents from now on.

No sangres los párrafos con espacios ni tabulaciones.

Énfasis

Puedes agregar énfasis poniendo el texto en negrita o cursiva.

Para poner texto en negrita, añada dos asteriscos (**) o guiones bajos (__) antes y después de una palabra o frase.

Para poner en negrita la parte central de una palabra y darle énfasis, añada dos asteriscos sin espacios entre las letras.

Markdown HTML Rendered Output
I just love **bold text**. I just love <strong>bold text</strong>. I just love bold text.
I just love __bold text__. I just love <strong>bold text</strong>. I just love bold text.
Love**is**bold Love<strong>is</strong>bold Loveisbold

Para poner texto en cursiva, añada un asterisco (*) o un guion bajo (_) antes y después de una palabra o frase.

Para poner en cursiva la mitad de una palabra y darle énfasis, añada un asterisco sin espacios entre las letras.

Markdown HTML Rendered Output
Italicized text is the *cat's meow*. Italicized text is the <em>cat's meow</em>. Italicized text is the cat’s meow.
Italicized text is the _cat's meow_. Italicized text is the <em>cat's meow</em>. Italicized text is the cat’s meow.
A*cat*meow A<em>cat</em>meow Acatmeow

Para enfatizar el texto con negrita y cursiva simultáneamente, agrega tres asteriscos o guiones bajos antes y después de una palabra o frase.

Para poner en negrita y cursiva la parte central de una palabra y enfatizarla, agregue tres asteriscos sin espacios entre las letras.

Markdown HTML Rendered Output
This text is ***really important***. This text is <em><strong>really important</strong></em>. This text is really important.
This text is ___really important___. This text is <em><strong>really important</strong></em>. This text is really important.
This text is __*really important*__. This text is <em><strong>really important</strong></em>. This text is really important.
This text is **_really important_**. This text is <em><strong>really important</strong></em>. This text is really important.
This is really***very***important text. This is really<em><strong>very</strong></em>important text. This is reallyveryimportant text.

Citas en bloque

Para crear una cita en bloque, agrega una > delante de un párrafo.

> Dorothy followed her through many of the beautiful rooms in her castle.

La salida renderizada se ve así:

Dorothy followed her through many of the beautiful rooms in her castle.

Las citas en bloque pueden contener varios párrafos.

Añade una > en las líneas en blanco entre los párrafos:

> Dorothy followed her through many of the beautiful rooms in her castle.
>
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

La salida renderizada se ve así:

Dorothy followed her through many of the beautiful rooms in her castle.

The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

Las citas en bloque se pueden anidar.

Añada un signo >> antes del párrafo que quieras anidar.

> Dorothy followed her through many of the beautiful rooms in her castle.
>
>> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

Dorothy followed her through many of the beautiful rooms in her castle.

The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

Las citas en bloque pueden contener otros elementos con formato Markdown:

> #### The quarterly results look great!
>
> - Revenue was off the chart.
> - Profits were higher than ever.
>
>  *Everything* is going according to **plan**.

La salida renderizada se ve así:

The quarterly results look great!

  • Revenue was off the chart.
  • Profits were higher than ever.

Everything is going according to plan.

Listas

Puedes organizar elementos en listas ordenadas y desordenadas.

Listas ordenadas

Para crear una lista ordenada, agrega elementos con números seguidos de puntos.

No es necesario que los números estén en orden numérico, pero la lista debe comenzar con el número uno.

Markdown HTML Rendered Output
1. First item
2. Second item
3. Third item
4. Fourth item 		<ol>
  <li>First item</li>
  <li>Second item</li>
  <li>Third item</li>
  <li>Fourth item</li>
</ol>
  1. First item
  2. Second item
  3. Third item
  4. Fourth item
1. First item
1. Second item
1. Third item
1. Fourth item 		<ol>
  <li>First item</li>
  <li>Second item</li>
  <li>Third item</li>
  <li>Fourth item</li>
</ol>
  1. First item
  2. Second item
  3. Third item
  4. Fourth item
1. First item
8. Second item
3. Third item
5. Fourth item 		<ol>
  <li>First item</li>
  <li>Second item</li>
  <li>Third item</li>
  <li>Fourth item</li>
</ol>
  1. First item
  2. Second item
  3. Third item
  4. Fourth item
1. First item
2. Second item
3. Third item
    1. Indented item
    2. Indented item
4. Fourth item 		<ol>
  <li>First item</li>
  <li>Second item</li>
  <li>Third item
    <ol>
      <li>Indented item</li>
      <li>Indented item</li>
    </ol>
  </li>
  <li>Fourth item</li>
</ol>
  1. First item
  2. Second item
  3. Third item
    1. Indented item
    2. Indented item
  4. Fourth item

TODO