Texto y Maquetado

Aquí se describen los mecanismos más básicos de la escritura y el maquetado en Markdown.

Párrafos de texto

Markdown reconoce todo el texto escrito como texto simple salvo indicacion contraria.

El texto debe comenzar siempre sin tabulación ni espacios, y tiende a ser agrupado en un único párrafo. Para terminar un párrafo y comenzar otro hay dos opciones:

Dos espacios vacios o más al terminar el párrafo y cambiar de linea;
Intercalar una línea vacía entre un párrafo y el otro.

Fin de línea simple

Si se escriben varios renglones seguidos sin agregar espacios entonces éstos se renderizarán uno a continuación del otro.

Esto puede ser útil para mejorar el seguimiento por parte de git u otros controles de versiones, en caso de usarse.

párrafo previo

Si se escriben varios renglones seguidos 
sin agregar espacios entonces éstos se renderizarán
uno a continuación del otro.

Esto puede ser útil para mejorar el seguimiento 
por parte de git u otros controles de versiones, 
en caso de usarse.

Headings

Los encabezamientos (headings) funcionan como títulos y subtítulos del texto, permitiendo la división del texto en secciones. Éstos se marcan con numerales (#) al comienzo del texto. Cuantos más numerales, menos prioridad.

Ejemplo:

formato de headings - numerales

# Titulo
Introducción

## Subtitulo 1
Párrafo seccion #1

## Subtitulo 2
Párrafo seccion #1

Se reconocen hasta 6 jerarquías, al igual que en HTML.

Markdown	Jerarquía
`# texto heading`	1 (máxima)
`## texto heading`	2
`### texto heading`	3
`#### texto heading`	4
`##### texto heading`	5
`###### texto heading`	6 (mínima)

Una forma alternativa de crear tiulos y subtitulos es poner triple guion o triple signo igual justo debajo del texto de encabezamiento:

formato de headings - subrayado

Titulo
===

Subtitulo
---

sin embargo, este método permite menos jerarquías que los numerales y es menos intuitivo en la escritura.

Comentarios

Markdown acepta el comentado de contenido, el cual no será visible al renderizarlo. El formato del comentario es idéntico al que usa HTML:

Comentarios en MD

<!-- Comentario en Markdown -->

Este sistema de comentarios permite anular renglones enteros de contenido de forma sencilla. Para ello sólo hay que separar la secuencia de apertura ():

Contenido anulado en MD

<!-- 
Bloque 
de 
texto 
anulado.
-->

Líneas de División

Se pueden crear lineas de división rápidamente mediante una serie de asteriscos, guiones o guiones bajos:

---     # triple guion
***     # triple asterisco
___     # triple guion bajo

Todas estas opciones dan como resultado una línea horizontal que va de lado a lado de la pantalla:

Referencias

Markdown Guide.org - Headings

Markdown Guide.org - Horizontal rules