learnxinyminutes-docs/es-es/markdown-es.html.markdown

---
language: markdown
contributors:
    - ["Dan Turkel", "http://danturkel.com/"]
translators:
    - ["Daniel Zendejas", "https://github.com/DanielZendejas"]
-filename: es-markdown.md
---

Markdown was created by John Gruber in 2004. It's meant to be an easy to read and write syntax which converts easily to HTML (and now many other formats as well).

Give me as much feedback as you want! / Feel free to fork and pull request!


```
<!-- Markdown está basado en HTML, así que cualquier archivo HTML es Markdown
válido, eso significa que podemos usar elementos HTML en Markdown como, por
ejemplo, el comentario y no serán afectados por un parseador Markdown. Aún 
así si creas un elemento HTML en tu archivo Markdown no podrás usar sintaxis
Markdown dentro de él. -->

<!-- La implementación de Markdown cambia de acuerdo al parseador. Esta
guía servirá para clarificar cuales características son universales y
cuales son específicas de cada parseador-->

<!-- Headers -->
<!-- Puedes crear headers HTML fácilmente precediendo al texto con una serie
de símbolos de números (#)-->

# Esto es un <h1>
## Esto es un <h2>
### Esto es un <h3>
#### Esto es un <h4>
##### Esto es un <h5>
###### Esto es un <h6>

<!-- Markdown también nos proveé con dos alternativas para indicar h1 y h2 -->
Esto es un h1
=============

Esto es un h2
-------------

<!-- Estilos para texto plano -->
<!-- El texto puede ser fácilmente estilizaedo con italicas, negritas o tachado 
usando markdown -->

*Este texto está en itálicas.*
_Al igual que este texto._

**Este texto está en negritas.**
__Al igual que este texto.__

***Este texto tiene ambos estilos.***
**_Al igual que este!_**
*__¡Y este!__*

<!-- En Github Flavored Markdown, el cual es usado para mostrar archivos 
Markdown en Github, también tenemos: -->

~~Este texto está tachado.~~

<!-- Los párrafos son una o múltuples líneas de texto adyacentes separadas por 
una o múltiples líneas en blanco-->

Este es un párrafo. Estoy escribiendo un párrafo, ¿No es divertido?

Ahora estoy en el párrafo dos.
¡Sigo en el párrafo dos!

¡Estoy en el párrafo tres!

<!-- Si en algún momento quieres insertar un break HTML <br />, puedes terminar
un párrafo con dos o más espacios y luego empieza un párrafo nuevo-->

Termino con dos espacios (selecciona esta línea completa para que los veas).  

¡Hay un <br /> arriba de mí!

<!-- Las citas de bloque son fáciles y se pueden hacer con el caracter >. -->

> Esta es una cita de bloque. Puedes
> envolver tus líneas manualmente y poner un `>` antes de cada línea o puedes dejar que tus líneas sean muy largas y que se envuelvan solas.
> No hay diferencia, siempre y cuando empiecen con `>`.

> ¿También puedes usar más de un nivel
>> de indentación?
> Esto es muy útil ¿No?

<!-- Listas -->
<!-- Las listas desordenadas se hacen usando asteriscos, símbolos de más,
 o guiones -->

* Item
* Item
* Otro item

o

+ Item
+ Item
+ Un item más

o

- Item
- Item
- El último item

<!-- Las listas ordenadas se logran con un número seguido de un punto -->

1. Item uno
2. Item dos
3. Item tres

<!-- Aunque Markdown mostrará los items correctamente en orden, esto no
es una buena idea -->

1. Item uno
1. Item dos
1. Item tres
<!-- (Esto muestra lo mismo que el ejemplo de arriba) -->

<!-- También puedes usar sub-listas -->

1. Item uno
2. Item dos
3. Item tres
    * Sub-item
    * Sub-item
4. Item cuatro

<!-- Bloques de código -->
<!-- Puedes indicar un bloque de código (usan los elementos <code>) indentando 
una línea con cuatro espacios o un tab-->

    Esto es código
    Esto también

<!-- También puedes insertar dos tabs (o cuatro espacios adicionales)
para indentar dentro del código -->

    my_array.each do |item|
        puts item
    end

<!-- Código dentro de la línea puede ser escrito usando la comilla ` -->

¡John no sabía lo que la función `go_to()` hacía!

<!-- Con Github Flavored Markdown, puedes usar una sintaxis especial para código -->

\`\`\`ruby <!-- quita esas comillas cuando lo hagas, deja sólo ```ruby ! -->
def foobar
    puts "Hello world!"
end
\`\`\` <!-- aquí también, sin comillas, sólo ``` -->

<!-- El texto de arriba no necesita indentación, aparte Github usará
resaltará la sintaxis del lenguaje que especifiques después de ``` -->

<!-- Regla horizontal (<hr />) -->
<!-- Las reglas horizontales se agregan fácilmente con tres o más asteriscos o guiones,
con o sin espacios. -->

***
---
- - - 
****************

<!-- Ligas -->
<!-- Una de las mejores cosas de Markdown es la facilidad para hacer ligas. Pon
el texto a mostrar en corchetes [] seguidos por la URL en paréntesis () -->

[¡Haz click!](http://test.com/)

<!-- También puedes agregar el titulo de la liga usando comillas dentro de los paréntesis -->

[¡Haz click!](http://test.com/ "Liga al test.com")

<!-- También funcionan las rutas relativas. -->

[Ir a la música](/music/).

<!-- Markdown también soporta ligas con estilo de referencia -->

¡[Has click a esta liga][liga1] para más información!
[También mira esta liag][foobar] si quieres.




<!-- El título también puede estar en comillas simples o dentro de paréntesis,
también se pueden omitir completamente. Las referencias pueden estar en cualquier
lugar en tu documento y los IDs de referencia pueden ser lo que sea mientras sean únicos. -->

<!-- También hay "nombramiento implicito" el cual te permite usar el texto de la liga como id -->

[Esta][] es una liga.



<!-- Pero no se usa comúnmente. -->

<!-- Imagenes -->
<!-- Las imagenes se hacen de la misma forma que las ligas pero con un símbolo de exclamaciónal frente! -->

![Esta es una etiqueta (texto alternativo) para mi imagen](http://imgur.com/myimage.jpg "Un titulo opcional")

<!-- Y el estilo de referencia funciona como se espera -->

![Esta es una etiqueta.][myimage]



<!-- Misceláneos -->
<!-- Auto-ligas -->

<http://testwebsite.com/> equivale a
[http://testwebsite.com/](http://testwebsite.com/)

<!-- Auto-ligas para correos electrónicos -->

<foo@bar.com>

<!-- Escapando caracteres -->

Quiero escribir *este texto rodeado por asteriscos* pero no quiero que esté en itálicas,
así que hago esto: \*Este texto está rodeado de asteriscos\*.

<!-- Tablas -->
<!-- Las tablas sólo están disponibles en Github Flavored Markdown y son un poco pesadas,
pero si de verdad las quieres: -->

| Col1         | Col2     | Col3          |
| :----------- | :------: | ------------: |
| Izquierda | Centrado | Derecha |
| blah         | blah     | blah          |

<!-- o, para los mismos resultados -->

Col 1 | Col2 | Col3
:-- | :-: | --:
Ugh esto es feo | has que | pare.

<!-- ¡El fin! -->

```

For more info, check out John Gruber's official post of syntax [here](http://daringfireball.net/projects/markdown/syntax) and Adam Pritchard's great cheatsheet [here](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).