Hoja de Referencia de Sintaxis Markdown: De Principiante a Avanzado

Introducción

Markdown es un lenguaje de marcado ligero que te permite escribir documentos usando un formato de texto plano fácil de leer y escribir. Esta hoja de referencia cubre toda la sintaxis de Markdown desde básica hasta avanzada, con ejemplos prácticos. Ya seas principiante en Markdown o necesites consultar una sintaxis específica, esta guía te ayudará.

Sintaxis básica

Encabezados (Headings)

Markdown admite seis niveles de encabezados, usando el símbolo #:

# Encabezado de nivel 1
## Encabezado de nivel 2
### Encabezado de nivel 3
#### Encabezado de nivel 4
##### Encabezado de nivel 5
###### Encabezado de nivel 6

También puedes usar el formato de subrayado (solo admite nivel 1 y 2):

Encabezado de nivel 1
====================

Encabezado de nivel 2
--------------------

Párrafos y saltos de línea

Los párrafos necesitan líneas vacías para separarse. Si necesitas un salto de línea sin iniciar un nuevo párrafo, agrega dos espacios al final de la línea.

Este es el primer párrafo.

Este es el segundo párrafo.

Esta es una línea  
Esta es la siguiente línea (nota los dos espacios al final de la línea anterior)

Formato de texto

Efecto	Sintaxis	Ejemplo
Negrita	**texto** o __texto__	texto en negrita
Cursiva	*texto* o _texto_	texto en cursiva
Negrita y cursiva	***texto***	texto en negrita y cursiva
Tachado	~~texto~~	texto tachado
Código en línea	`código`	código en línea

Listas

Listas desordenadas

Usa -, *, o + para crear listas desordenadas:

- Elemento 1
- Elemento 2
  - Elemento anidado 2.1
  - Elemento anidado 2.2
- Elemento 3

Listas ordenadas

Usa números seguidos de puntos:

1. Primer elemento
2. Segundo elemento
   1. Elemento anidado 2.1
   2. Elemento anidado 2.2
3. Tercer elemento

Enlaces

Hay varias formas de crear enlaces:

[Texto del enlace](https://ejemplo.com)
[Texto del enlace con título](https://ejemplo.com "Título del enlace")

[Enlace de referencia][1]

[1]: https://ejemplo.com

Imágenes

La sintaxis de imágenes es similar a la de los enlaces, pero con un ! al principio:

![Texto alternativo](imagen.jpg)
![Texto alternativo](imagen.jpg "Título de la imagen")
![Imagen de referencia][logo]

[logo]: imagen.jpg "Título de la imagen"

Sintaxis avanzada

Tablas

Crea tablas usando barras verticales |:

| Encabezado 1 | Encabezado 2 | Encabezado 3 |
|--------------|:-------------|-------------:|
| Celda 1      | Celda 2      | Celda 3      |
| Izquierda    | Centrado     | Derecha      |

Alineación de columnas:

• :--- Alineación a la izquierda
• :---: Alineación centrada
• ---: Alineación a la derecha

Bloques de código

Para bloques de código, usa tres comillas invertidas:

```javascript
function saludar(nombre) {
  console.log("¡Hola, " + nombre + "!");
}
```

Citas

Usa > para crear citas:

> Esta es una cita.
> Puede extenderse a múltiples líneas.
> 
> > Esta es una cita anidada.

Líneas horizontales

Crea líneas horizontales usando tres o más de estos caracteres:

---
***
___

GitHub Flavored Markdown

Listas de tareas

- [x] Tarea completada
- [ ] Tarea pendiente
- [ ] Otra tarea pendiente

Menciones y referencias

@usuario
#123 (referencia a issue)
SHA: commit

Bloques de código con resaltado

```python
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)
```

Mejores prácticas

1. Consistencia en el formato

• Elige un estilo y mantente consistente
• Usa espacios consistentes para la indentación
• Mantén la misma sintaxis para elementos similares

2. Legibilidad

• Deja líneas vacías entre diferentes tipos de elementos
• Usa encabezados para estructurar el contenido
• Evita líneas demasiado largas

3. Compatibilidad

• Prueba tu Markdown en diferentes renderizadores
• Usa características ampliamente soportadas
• Proporciona fallbacks para características avanzadas

Errores comunes

1. Espacios en blanco

Los espacios son importantes en Markdown. Algunos errores comunes:

• Olvidar espacios después de # en encabezados
• No usar espacios consistentes en listas
• Espacios innecesarios al final de líneas

2. Caracteres especiales

Algunos caracteres necesitan escape:

\* Asterisco literal
\# Numeral literal
\[ Corchete literal

3. Listas anidadas

La indentación debe ser consistente:

1. Primer elemento
   - Subelemento (3 espacios)
   - Otro subelemento
2. Segundo elemento

Extensiones de Markdown

Matemáticas (LaTeX)

Muchos renderizadores admiten LaTeX:

Ecuación en línea: $E = mc^2$

Bloque de ecuación:
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$

Diagramas

Algunos renderizadores admiten diagramas:

```mermaid
graph TD
    A[Inicio] --> B{Decisión}
    B -->|Sí| C[Acción 1]
    B -->|No| D[Acción 2]
```

Herramientas para Markdown

Editores

• MD-PDF-WORD: Convierte Markdown a PDF y Word
• Typora: Editor WYSIWYG
• Mark Text: Editor de tiempo real
• Visual Studio Code: Con extensiones de Markdown

Convertidores

• Pandoc: Conversor universal de documentos
• MD-PDF-WORD: Especializado en PDF y Word
• Marked: Biblioteca JavaScript

Conclusión

Markdown es una herramienta poderosa y versátil para crear documentos. Con esta hoja de referencia, tienes todo lo que necesitas para crear documentos profesionales. Recuerda que la práctica hace al maestro, así que comienza con la sintaxis básica y ve expandiendo gradualmente tu conjunto de habilidades.

Para una conversión perfecta de tus documentos Markdown a PDF o Word, prueba MD-PDF-WORD. Ofrece la conversión más simple y confiable mientras mantiene todos los elementos de formato intactos.