Markdown

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

web/document/markdown

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:

markdown

# 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

markdown

### 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

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.

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.
`Loveisbold`	`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.
`Acatmeow`	`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.

markdown

> 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:

markdown

> 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.

You're reading a preview.

Sign in to read the full article. Any account opens 4 free articles a month; students and teachers read their course pages without limit.

Markdown

#Introducción

#Entorno de trabajo

#Sintaxis básica

#Encabezados

#Heading level 1

#Heading level 2

#Heading level 3

#Heading level 4

#Heading level 5

#Heading level 6

#Párrafos

#Énfasis

#Citas en bloque

Introducción

Entorno de trabajo

Sintaxis básica

Encabezados

Heading level 1

Heading level 2

Heading level 3

Heading level 4

Heading level 5

Heading level 6

Párrafos

Énfasis

Citas en bloque