Markdown
Markdown es un lenguaje interpretado liviano para presentación documental creado por Aaron Schwartz, y orientada a la web.
El documento se escribe en texto plano, y será interpretado por el parser, que lo presentará en un documento gráfico el cual tu navegador podrá ilustrar en pantalla.
Tutorial básico de Markdown
Este tutorial ha sido amablemente contribuido por ~hora_z.
Saltos de linea y espacios
Para generar un nuevo párrafo en Markdown hay que poner una línea en blanco (pulsando dos veces Intro).
Para realizar un salto de línea y empezar una frase en una línea siguiente sin cambiar de párrafo, hay que pulsar dos veces la barra espaciadora antes de pulsar una vez Intro.
Títulos o encabezados
# Encabezado 1 ## Encabezado 2 ### Encabezado 3 #### Encabezado 4 ##### Encabezado 5 ###### Encabezado 6
También es posible definir dos niveles de encabezado usando =
y -
.
Esto logra un Encabezado Principal:
===
Esto logra un Encabezado Secundario:
---
Cita
> esto es una cita - autor de la cita
Si son varios párrafos, añadir >
a cada uno, con el -
para el autor al final de ambos
Usar »
para cita anidada.
> cita principal >> cita anidada > Vuelve a la principal
Listas
Usar *
, -
o +
para una lista con viñetas.
Para anidar listas usar 4 espacios en blanco antes del *
Para crear listas numeradas, usar el formato 1.
Se pueden anidar y mezclar las numeradas con las comunes:
1. Frutas * Manzana * Banana 2. Verduras - Lechuga - Tomate
Bloque <pre>
Encerrar el párrafo entre tres tildes ~~~
~~~ párrafo de bloque corresponde al ~~~
Regla horizontal
*** --- ___
Tachado, Negrita y cursiva
~~Texto tachado~~ *cursiva* / **negrita** / ***cursiva y negrita*** _cursiva_ / __negrita__ / ___cursiva y negrita___
Enlaces
[texto del enlace](http://URL_Link)
Enlaces de referencia: Es para no llenar el texto de enlaces haciéndolo ilegible. El texto enlaza un código que será definido en un lugar más apartado (al final del documento o del párrafo/capítulo)
[texto del enlace][nombre de referencia]
Más abajo ponés el enlace real:
[nombre de referencia]: http://URL_Link
Si la idea es que se vea el enlace:
<http://URL_Link>
Enlace de referencia cruzado: es cuando el enlace dirige a una parte del mismo documento:
Texto que querés referenciar {#nombreReferencia}
Luego, cuando necesites enlazarlo:
este es el [enlace a la referencia](#nombreReferencia)
Normalmente se referencian los títulos o encabezados. El ejemplo más claro es el índice de contenidos.
Codigo <code>
'este texto será mostrado como código'
Otra manera es añadiendo 4 espacios en blanco, equivale a la etiqueta <pre>
, pero hay que hacerlo en cada linea. Por eso es mejor usar las tres ~
.
Imágenes
Se hace igual que los enlaces comunes, pero debes anteponer el signo !
:
![Texto alternativo](http://URL_Link/imagen.jpg "Título alternativo")
Al igual que con los enlaces, se pueden referenciar para no ensuciar el texto:
![Texto alternativo][img1] ![Otro texto alternativo][img2]
Referenciado:
[img1]: http://URL/imagen1.jpg "Título alternativo1" [img2]: http://URL/imagen2.jpg "Título alternativo2"
Se puede especificar el tamaño, por ejemplo:
Omitir la interpretación de MD
Utiliza anteponer barra invertida al carácter para anular la interpretación de caracteres: \
Multi MarkDown MMD
Se trata de una versión extendida con algunas funcionalidades adicionales.
Abreviaturas
Igual que crear links de referencia, pero con las siglas. MMD ofrece posibilidades extendidas a MD
*[MMD]: Multi MarkDown *[MD]: MarkDown
Definiciones
Utiliza :
indentados para agregar definiciones:
Término a definir : Definición del término : Otra definición que amplía la anterior
Metadatos
Información sobre el documento que no se ve como parte del contenido. No debe haber espacio en blanco antes de los metadatos. Si se pone un salto de linea en blanco, se dará por terminado el bloque de metadatos. Solo funcionan en inglés.
Algunos metadatos útiles:
Title
: Título del documentoAuthor
: Autor del documentoDate
: Fecha del documentoComment
: Comentario acerca del documentoEmail
: ¿Hace falta describir esto?Keywords
: palabras, clave, separadas, por, comasWeb
: Si querés incluir la web del autor o del textoCopyright
: El tipo de licencia del documento
Tablas
Se pueden usar los dos puntos para alinear las columnas.
| Encabezado | Otro encabezado | y otro más| |---|:---:|---:| |datos|datos|y más datos|
Notas al pie
[^nombreDeLaNota]
y al pie:
[^nombreDeLaNota]: texto de la nota