Estás aquíMarkdown
Markdown
Markdown está diseñado para convertir texto plano estilizado en formato HTML. Funciona así:
Itálicas y Negritas
*Esto está en itálicas*, y también _esto_.
**Esto está en negritas**, y también __esto__.
Usa ***itálicas y negritas al mismo tiempo*** si realmente ___lo necesitas___.
Links básicos
Hay tres maneras de escribir links. Cada una es más fácil de leer que la anterior:
Este es un link sencillo a [Google](http://www.google.com/).
Este es un link referenciado a [Google][1].
Este es un link que se lee muy fácilmente a [Yahoo!][yahoo].
[1]: http://www.google.com/
[yahoo]: http://www.yahoo.com/
Las definiciones de links pueden aparecer en cualquier parte del documento, antes o después del lugar donde los uses. Los nombres de links referenciados (1 y yahoo) pueden ser cualquier string único, y no distinguen diferencias entre mayúsculas o minúsculas; [yahoo] es igual a [YAHOO].
Links avanzados
Los links pueden tener un título (que se muestra cuando el mouse está sobre él). Los títulos ayudan cuando tu link no es lo suficientemente descriptivo como para indicar a tus usuarios a donde van.
Este es un link con un nombre poco [descriptivo](http://www.google.com/ "Google").
Nunca pongas "[haz click aquí][2]".
[2]: http://axai.com.mx/ "Axai Soluciones Avanzadas"
También puedes usar HTML estándar para poner hiper-vínculos.
<a href="http://foo.com" title="foo">foo</a>
URLs
Para que un url normal sea convertido a una liga, basta con ponerle tags: <http://axai.com.mx>
Encabezados
Subraya un texto para hacerlo un encabezado:
Encabezado 1
============
Encabezado 2
--------------
El número de = o - no importa; con que pongas uno basta. Pero al usar los suficientes para subrayar todo el texto hace que tus títulos se vean mejores en texto plano.
Utiliza signos de gato si quieres tener más niveles de títulos:
# Header 1 #
## Header 2 ##
### Header 3 ###
Los caracteres # de cierre son opcionales.
Reglas horizontales
Inserta una regla horizontal poniendo tres o más guiones, asteriscos o guiones bajo en una línea:
---
*******
___
Usar espacio entre los caracteres también funciona:
- - - -
Listas sencillas
Una lista sin ordenar:
- Usa el signo de menos
+ O el de más
* O un asterisco para una lista sin ordenar
Listas numeradas:
1. Las listas numeradas son sencillas
2. Markdown lleva la cuenta de la numeración por tí
7. Así que este es el número 3.
Lista con doble espaciado:
- Esta lista estará envuelta en <p>
- Así que habrá espaciado extra entre cada línea
Listas anidadas:
Para poner un bloque de Markdown anidado dentro de una lista; sólo indenta con 2 o cuatro espacios por cada nivel.
1. Listas en una lista:
- Indentado cuatro veces.
* Indentado ocho veces.
- Cuatro veces otra vez.
2. Múltiples párrafos en una lista:
Es mejor indentar los párrafos con cuatro espacios
puede funcionar con tres, pero se puede poner
confuso cuando anidas otras cosas.
Cuatro es mejor.
Indentamos la primera línea con un espacio extra para que se alineara
con estos párrafos. En un caso real, podríamos hacer eso con
toda la lista para que todos los ítems estén alineados.
Este párrafo también es parte de la lista, pero se ve mal en el ojo humano. Así que es una buena idea dar saltos de línea manualmente para que sean más legibles como en los primeros dos párrafos.
3. Citas en una lista:
> Salta una línea e
> indenta los > con cuatro espacios.
4. Texto preformateado en una lista:
Salta una línea e indenta ocho veces.
Esto es, cuatro veces para la lista
y cuatro para activar el bloque de código
Código y texto preformateado
Indenta con cuatro espacios para crear un bloque de código preformateado.
printf("adiós mundo cruel!"); /* su nota suicida
estaba C */
El texto será envuelto en <pre>, así que el navegador lo mostrará en con alguna fuente monospaced. Los primeros cuatro espacios se quitarán, pero todo el resto del espacio en blanco será preservado.
Markdown o HTML es ignorado dentro de un bloque de código, así que es una manera conveniente de enseñar la sintaxis de Markdown o HTML:
<blink>
Odiarías esto si no estuviera
envuelto en un bloque de código.
</blink>
Código en línea
Para poner <código> en la misma línea que estás escribiendo sólo tienes que usar backticks:
Presiona la tecla `<Tab>`.
Como los bloques de código, el código en línea será desplegado con una fuente monospace. Markdown y HTML no funcionan dentro del código en línea.
Saltos de línea
Agrega un salto de línea <br/> terminando la línea con dos espacios.
Citas sencillas
Sólo añade un > al principio de cada línea para crear un bloque de cita.
> La sintaxis está basada en lo que usan los programas de email
> normalmente para las citas. No necesitas poner el > en cada línea
> de tu párrafo, pero se ve mejor si lo haces. Depende de qué tan flojo te sientas.
Citas anidadas
Para poner otros bloques de Markdown en tu cita, sólo agrega un > seguido de un espacio.
Citas dentro de citas:
> Una cita normalmente está indentada
> > Una cita anidada está indentada un poquito más
> > > > Puedes anidar a cualquier nivel que quieras.
Listas en una cita:
> - Una lista en una cita
> - Con un > y un espacio antes del -
> * Una sublista
Texto preformateado en una cita:
> Indenta cinco espacios en total. El primero
> es parte de un bloque de cita.
Imágenes
Las imágenes son exáctamente iguales a los links, pero tienen un signo de exclamación antes de ellas:
.
El texto en los brackets es el texto alternativo, que se despliega si el navegador no puede mostrar la imagen. Este texto es leído para los usuarios ciegos que tienen algún software que les lea el contenido de la página.
Justo como los links, las imágenes pueden usar referencias y títulos:
Esta página es ![XHTML válido][checkmark].
[checkmark]: http://w3.org/Icons/valid-xhtml10
También puedes usar HTML estándar, que te permite escalar la imágen a la altura y anchura que prefieras.
<img src="http://foo.com/sample.png" width="100" height="100" />
HTML
Si necesitas hacer algo que Markdown no soporta, puedes usar HTML.
El humor tachado es <strike>gracioso</strike>.
Los bloques de HTML tienen algunas restricciones:
- Deben estar rodeados de líneas en blanco.
- El primer y último tag del bloque no pueden estar indentados.
No se puede usar Markdown dentro de un bloque de HTML.
<div style="background-color: lightgray"> No puedes <em>usar</em> Markdown aquí =(. </div>
¿Necesitas más información?
Visita la página oficial de la sintaxis de Markdown.
Este texto está traducido de Stack Overflow</br/></código>