Guía para el uso de Markdown

Guía para el uso de Markdown

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

  1. Ciencia
  2. Geografía
  3. 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:

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

Sin comentarios
Ha habido un error en el envío
Comentario enviado. Será revisado por la moderación antes de ser publicado.

Deja tu comentario

Tu nombre:
Tu email:
Tu comentario:
Nuestra página web utiliza cookies propias y de terceros, para realizar el análisis de la navegación de los usuarios y así poder mejorar nuestros servicios. Si continúas navegando, consideramos que aceptas su uso. Puedes cambiar la configuración u obtener más información aquí