Descarga el código: markdown-es.md
Markdown fue creado por John Gruber en 2004. Su propósito es ser una sintaxis fácil de leer y escribir que se convierta fácilmente a HTML (y, actualmente, otros formatos también).
¡Denme toda la retroalimentación que quieran! / ¡Sientanse en la libertad de hacer forks o pull requests!
<!-- 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 estilizado 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últiples 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 -->
<[email protected]>
<!-- 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! -->
Para más información, mira el post oficial de John Gruber’s aquí y la gran referencia de Adam Pritchard’s aquí.
¿Tienes una sugerencia o rectificación? Abre un issue en el repositorio de GitHub, o haz un pull request tu mismo
Originalmente contribuido por Dan Turkel, y actualizado por 4 colaborador(es).