Es fácil explicar por qué los diseñadores y desarrolladores deciden aprender Markdown. Es fácil de escribir, semánticamente ligero, y rápido en lo que respecta a los artículos con formato y texto plano.
Hoy en día es ampliamente utilizado en la escritura de artículos, documentación, textos de ayuda, etc. En este artículo, vamos a hablar acerca de la sintaxis y los recursos básicos, donde cualquier persona puede enriquecer sus conocimientos.
- Heading
Para escribir un epígrafe HTML de Markdown usamos # (almohadilla). Si queremos cambiar entre h1 y h6 , cambiamos el número de # utilizadas.
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
Resultado:
Heading 1
Heading 2
Heading 3
Heading 4
Heading 5
Heading 6
- Listas
Markdown soporta dos elementos de lista, listas ordenadas (numeración) y listas no ordenadas (viñetas). Las listas no ordenadas utilizan * (asteriscos), + (más) y – (guiones) indistintamente como marcadores de lista:
* Ciencia
* Geografía
* Ganadería
+ Ciencia
+ Geografía
+ Ganadería
- Ciencia
- Geografía
- Ganadería
Resultado:
- Ciencia
- Geografía
- Ganadería
- Ciencia
- Geografía
- Ganadería
- Ciencia
- Geografía
- Ganadería
Las listas numeradas son sencillas, porque Markdown comprueba los números por ti.
1. Ciencia
2. Geografía
3. Ganadería
Resultado
- Ciencia
- Geografía
- Ganadería
- Elementos de lista anidados
Para crear elementos de lista anidados sólo tenemos que aplicar una sangría. Las listas anidadas se pueden hacer con guiones de cuatro espacios y de ocho espacios.
1 . Biblioteca JavaScript
- jQuery ; . // sangría cuatro espacios
* jQuery Mobile . // sangría ocho espacios
- Node.js y Angular // Cuatro espacios de nuevo.
Resultado:
- Biblioteca JavaScript
- jQuery;
- jQuery Mobile
- Node.js y Angular
- Reglas horizontales
En HTML, insertamos una etiqueta <hr/> para obtener una regla horizontal, pero en Markdown vamos a utilizar tres o más guiones, asteriscos o guiones bajos en una línea. Todos ellos funcionan igual.
Regla 1
*******
Regla 2
====
Resultado:
Regla 1
Regla 2
- Párrafos
Para escribir un párrafo o texto en HTML, utilizamos las etiquetas predefinidas <p> </p>, pero en Markdown, un bloque de texto se convierte automáticamente en un párrafo. Para una línea en blanco, dos espacios se utilizan en lugar de una etiqueta <br>.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed consectetur magna in mi elementum rutrum. In elementum vel eros at iaculis. Suspendisse iaculis hendrerit lectus, dapibus porttitor ligula volutpat non.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed consectetur magna in mi elementum rutrum. In elementum vel eros at iaculis. Suspendisse iaculis hendrerit lectus, dapibus porttitor ligula volutpat non.
- Cursiva y negrita
El párrafo y el formato de texto plano son sencillos en Markdown. Utilizamos asteriscos individuales * alrededor del texto para el texto en cursiva. También podemos utilizar un guión bajo _ en lugar de * para el formato de cursiva. El mismo formato se utiliza para el texto en negrita, excepto que sólo tendremos que utilizar el doble asterisco ** o doble subrayado __. Por último, podemos utilizar el asterisco tres veces *** o subrayado tres veces ___ para aplicar el formato negrita y cursiva.
* El texto en cursiva *, también es _este_ . * * Texto en negrita * * , y también lo es __este__ . Utiliza * * * cursiva y negrita juntos * * * si ___tienes que hacerlo___ .
Resultado
El texto en cursiva, también es este . Texto en negrita, y también lo es este. Utiliza cursiva y negrita juntos si tienes que hacerlo.
- Código
Para escribir un bloque de código, podemos utilizar el carácter de acento grave (`` ` ) alrededor del código. Cuando estamos trabajando con bloques de código en línea sólo tienes que utilizar el acento grave una vez.
`` `
< nav >
< ul >
< li > < / li >
< li > < / li >
< li > < / li >
< / ul >
< / nav >
`` `
o
`Hola ! '
- Imágenes
Para agregar un enlace de imagen vamos a utilizar la siguiente sintaxis:
` ! [ Texto Alt ] ( imagen / path / img . jpg ) ` * * Alt Texto * *
El carácter exclamación ! es necesario para declarar imágenes.
- Enlaces
Markdown admite dos estilos de formato de enlaces. Uno de ellos es el inline y el otro es la referencia de enlaces. Para crear un enlace inline tenemos que utilizar las siguientes markups [Texto] (http://www.example.com)
Por otra parte, para los enlaces de referencia tenemos que utilizar un segundo conjunto de corchetes, en el que se coloca una etiqueta de tu elección para identificar el enlace. A continuación los ejemplos:
// inline
[Ejemplo.com](http://ejemplo.com)
// Referencia
Esto es [un ejemplo][1] Enlace de Referencia.
[1]: http://ejemplo.com
- Blockquotes
Para escribir blockquotes agregamos > (mayor que) delante de un bloque de texto. Si estás citando pasajes de texto en un mensaje de correo electrónico, entonces sabes cómo crear un blockquote en Markdown.
> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed consectetur magna in mi elementum rutrum. In elementum vel eros at iaculis. Suspendisse iaculis hendrerit lectus, dapibus porttitor ligula volutpat non.
Resultado:
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed consectetur magna in mi elementum rutrum. In elementum vel eros at iaculis. Suspendisse iaculis hendrerit lectus, dapibus porttitor ligula volutpat non.
- Recursos
Aquí tienes algunos recursos para ayudarte a aprender un poco más sobre Markdown.
Herramientas de Markdown online
Estas son algunas de las herramientas online que te ayudarán a escribir en Markdown.
Comentarios