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.

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

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 documento
  • Author: Autor del documento
  • Date: Fecha del documento
  • Comment: Comentario acerca del documento
  • Email: ¿Hace falta describir esto?
  • Keywords: palabras, clave, separadas, por, comas
  • Web: Si querés incluir la web del autor o del texto
  • Copyright: 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
  • markdown.txt
  • Última modificación: 2022/12/23 21:54
  • por peron