Markdown es un lenguaje de marcado ligero que permite a la gente escribir y leer de forma muy fácil en formato de texto plano, luego se renderiza en modo HTML (u otro formato) para lograr lo que se ve a lo largo de este tutorial. Todo ello sin necesitar de ningún programa de tipo office para realizar la edición del texto. Solo es necesario un editor de texto simple, y saberse o tener a mano esta recopilación de símbolos, y empezar a escribir.
AVISOS: en la gran mayoría de casos (no todos), hay que dejar un espacio entre el símbolo empleado y el texto, en caso contrario no funcionará. Esta recopilación está hecha para que funcione en GitHub, no todas las páginas web ni visualizadores de markdown, lo tratan de la misma forma.
Existen conversores de Markdown a otros formatos de forma automática, como este online que lo convierte en pdf www.markdowntopdf.com/.
O este plugin de Visual Studio Code Plugin VisualStudioCode que puede convertir a varios formatos.
- Recopilación de Markdown hecha por Xibhu en Español
- Índice
- Índices
- Títulos y párrafos
- UNO
- Otro tipo de título 1
- Espacios y separador
- Listas
- CheckBox
- Dar énfasis al texto
- Tablas
- Citar texto
- Utilizar código
- Links
- Links imágenes
- Fuentes
Para colocar los índices, se debe colocar todo el texto en minúsculas y separar con guiones. Se puede hacer referencia a cualquier nivel de #, tanto ## como los siguientes.
[Mi sitio](#mi-sitio)# Títulos y párrafosExisten los títulos desde nivel 1 hasta nivel 6.
# UNO
## DOS
### TRES
#### CUATRO
##### CINCO
###### SEISOpcionalmente se puede declarar los mismos símbolos para hacer un cierre, en algún caso puede ser interesante o necesario, por tema de utilizar dentro cierta simbología.
## DOS ##Un par de formas más de hacer títulos. Se coloca el signo en la línea de debajo, y se pone mínimo 1, y los que se quiera, no tiene un efecto distinto a cuantos más se pongan. Con ello se consiguen de nivel 1 y 2.
Otro tipo de título 1
=Y uno un poco más pequeño 2
-Esto es un párrafo simple con todo el texto seguido. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Esto es un párrafo único que puede tener todo el texto que se quiera que va a ir todo igual, y se separa del párrafo de encima. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
El código sería el siguiente, para hacer párrafos se deja una lina en blanco en el medio.
Esto es un párrafo simple con todo el texto seguido.Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
Esto es un párrafo único que puede tener todo el texto que se quiera que va a ir todo igual, y se separa del párrafo de encima. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.Si se quiere hacer párrafos pero
con líneas más cortas, lo único
que hay que hacer es poner dos
espacios al final de cada línea.
Después de "pero", "único" y "dos" hay dos espacios normales. Si se quitan los espacios, se comportaría como el párrafo de LOREM IPSUM de arriba.
Si se quiere hacer párrafos pero
con líneas más cortas, lo único
que hay que hacer es poner dos
espacios al final de cada línea.Esto sería un separador horizontal, a elegir uno, los 3 actúan igual
---
___
***Colocar donde se necesiten, son espacios en horizontal en bloque, indivisibles, cada uno duplica en tamaño al anterior. Ya que automáticamente se reducen todos los espacios a uno, no se puede hacer "esto de aquí".
Un espacio
Dos espacios anteriores  
Dos espacios anteriores, o cuatro del primero  
Para dejar mayor separación y mejorar el entendimiento de la página, se pueden dejar más espacios, pero no con líneas vacías porque ocurre lo mismo que con los espacios horizontales, se reducen a uno solo. Para ello utilizaremos la etiqueta HTML <br> tantas como espacios queramos, y donde queramos directamente en el archivo de texto. Para dejar mayor espacio entre este texto y "Listas" de a continuación he utilizado <br><br>.
Se puede utilizar tanto el guión o signo menos (-), la suma (+) y el asterisco (*) de forma indiferente. Se aconseja utilizarlos para distinguir fácilmente entre los distintos niveles de las sublistas.
- primero
- segundo
- tercero
- primero
- segundo
- tercero Indistintamente de la numeración, sigue un orden concreto.
- asd
- asdrfe
- agfds
- gdfs
1. asd
1. asdrfe
1. agfds
2. gdfsLo único a tener en cuenta es el primer número, si quieres empezar la lista por el 6.
- algo
- asd
- gfd
6. algo
3. asd
675. gfdSe deja un tabulador o espacio hasta donde se quiera establecer los puntos interiores.
Para los números romanos es lista ordenada, pero siendo interior.
- Paso 1
- Perico
- de
- los
- palotes
- y más
- y más
- y más
- y más
- y más
- Paso 2
- archivo
- más
- y otro
- más
- Paso 3
1. Paso 1
- Perico
- de
- los
- palotes
+ y más
* y más
- y más
* y más
+ y más
2. Paso 2
1. [archivo](holamundo.txt)
2. más
3. y otro
4. más
3. Paso 3- Esto es un checkbox
- Y esto uno marcado
- (texto) a dsa
- [ ] Esto es un checkbox
- [x] Y esto uno marcado
- [ ] (texto) a dsa itálica itálica
*itálica* _itálica_negrita negrita
**negrita** __negrita__negrita itálica negrita itálica
***negrita itálica*** ___negrita itálica___texto enfasis texto
texto enfasis texto
texto enfasis texto
texto enfasis texto
texto enfasis texto
**texto _enfasis_ texto**
__texto *enfasis* texto__
**texto *enfasis* texto**
__texto _enfasis_ texto__
*texto __enfasis__ texto* (y sus combinaciones)tachado
~~tachado~~*ignorar markdown*
\*ignorar markdown\*| Column1 | Column2 | Column3 |
|---|---|---|
| Dato1 | Dato2 | Dato3 |
| Otro1 | Otro2 | Otro3 |
| yo |
| Column1 | Column2 | Column3 |
|---|---|---|
| Dato1 | Dato2 | Dato3 |
| Otro1 | Otro2 | Otro3 |
||yo|Los dos puntos sirven para indicar el alineado. Para hacer celdas vacías, es necesario colocar varias barras verticales.
| Column1 | Column2 | Column3 |
|---|---|---|
| Datoooooo1 | Datooooooo2 | Datooooooo3 |
| Otro1 | Otro2 | Otro3 |
| otro | ||
| mas | asd | |
| hgf | ||
| gghf |
Column1 | Column2 | Column3
---|:---:|---:
Datoooooo1 | Datooooooo2 | Datooooooo3
Otro1|Otro2|Otro3
otro
mas||asd
||hgf|
|||gghfUna cita normal.
Aquí va un texto, y es una cita
> Aquí va un texto, y es una citaCon varios simbolos uno debajo de otro.
y otra vez lo mismo y más de lo mismo
> y otra vez lo mismo
> y más de lo mismoUtilizando los dos espacios al final, tanto con un solo símbolo como uno por línea.
y otra vez lo mismo
y más de lo mismo en líneas
> y otra vez lo mismo
y más de lo mismo en líneasy otra vez lo mismo
y más de lo mismo en líneas
> y otra vez lo mismo
> y más de lo mismo en líneasY citas dentro de citas.
y otra vez lo mismo
y más de lo mismo en líneas
y máaaaas aún
> y otra vez lo mismo
>> y más de lo mismo en líneas
>>> y máaaaas aúnCodigo hay <aqui> en medio de una línea normal.
Codigo hay `<aqui>` en medio de una línea normal.Y también aquí, que ya es un bloque de texto, aunque se muestre una sola línea.
composer install
```
composer install
```Tambien puedo poner código fuente en bloque indicando el lenguaje concreto para que se resalte debidamente.
//Con un comentario
public static void main(String[] args){
System.out.printf("");
}```java
//Con un comentario
public static void main(String[] args){
System.out.printf("");
}
```Y para mostrar justo el código anterior, con su etiqueta de java sin que se transforme visualmente es envolviendo lo que se quiere con más tildes invertidas, una más en cada envoltorio. Es decir, que lo que se muestra a continuación tiene `````markdown, ````markdown, ```java. Y para mostrar estas 3 etiquetas sin que se trasformen en este mismo párrafo, se utiliza la forma de "ignorar markdown" anteriormente puesta en cada tilde invertida.
````markdown
```java
public static void main(String[] args){
System.out.printf("");
}
```
````Esto es un enlace simple https://www.google.es a google.
En el markdown de github, se detectan automáticamente los links y se resaltan solos.
Esto es un enlace a google.
[enlace](https://www.google.es)Esto es un enlace a google con title o tooltip (poner el ratón encima del enlace).
[enlace](https://www.google.es "Soy un tooltip y voy a google")Esto es un enlace a un fichero. Dependiendo de la ubicación, se puede realizar (../../ubi1/file2)
[enlace](carp/file "Con tooltip opcional")Esto es en el mismo fichero Ir al primer apartado Equivalente a los anchor de HTML. Es dirigirse a una sección de la página. OBLIGATORIO ponerlo todo en minúsculas, y sustituir espacios por guiones, en caso contrario no funciona.
[Ir al primer apartado](#títulos-y-párrafos "Con tooltip opcional")Esto es un link pero puesto en el texto en otra parte, modo referencia Voy a google
[Voy a google][1]
[1]: https://www.google.es "Con tooltip opcional"Link que se coge del valor de un texto, a modo de variable
[Link que se coge del valor de un texto, a modo de variable][por ejemplo esto]
[por ejemplo esto]: https://www.google.es "Con tooltip opcional"Dejando solo texto
Dejando [solo texto]
[solo texto]: https://www.google.es "Con tooltip opcional"Las imágenes son parecidas a los links, pero al principio llevan una exclamación. Se puede utilizar de la misma manera. En un solo link, referencia con número, referencia con palabras, o solo texto, todo con los tooltip opcionales.
Por revisar
https://help.github.com/articles/basic-writing-and-formatting-syntax/
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
https://gist.github.com/jonschlinkert/5854601
http://markdown-guide.readthedocs.io/en/latest/basics.html#code-inline
https://daringfireball.net/projects/markdown/syntax
Entre otros.