Get started
Blog

La chuleta de markdown más completa online

La chuleta de markdown más completa online. Todos los elementos de sintaxis con ejemplos, resultado renderizado, compatibilidad entre plataformas, errores comunes y consejos expertos. Guárdala en marcadores.

Benjamin McBrayer // Publicado: 21 de abril de 202618 min de lectura

También en

English

Markdown es una forma sencilla de dar formato al texto usando símbolos como almohadillas, asteriscos y corchetes. Es útil para escritores, bloggers, desarrolladores, estudiantes y cualquier persona que cree contenido online, porque permite formatear textos de forma rápida, limpia y fácil de reutilizar en distintas plataformas. Esta guía rápida de Markdown te mostrará las reglas más comunes para que puedas escribir y publicar con más confianza.

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero que te permite usar símbolos de texto plano para dar formato a documentos. Cuando escribes **negrita** obtienes negrita. Cuando escribes # Encabezado se convierte en un encabezado. Cuando usas Markdown, se convierte a HTML. Funciona en prácticamente cualquier plataforma y se ha convertido en el lenguaje por defecto para dar formato en miles de herramientas, plataformas y sitios web, incluidos GitHub, Reddit, Discord, Notion, Slack y Obsidian.

Por qué Markdown es importante

John Gruber creó Markdown en 2004 con el objetivo de permitir que la gente escribiera y diera formato a documentos usando texto plano sin tener que mirar un desorden de etiquetas. Hoy, Markdown ha crecido hasta convertirse en un lenguaje utilizado por prácticamente cualquier desarrollador o creador, así como por redactores de contenido y otras personas.

Los beneficios de Markdown

Markdown es tan popular porque resuelve muchos problemas que existían en formatos anteriores.

  • Markdown funciona en todas partes y siempre funcionará: Puedes abrir un archivo .md en cualquier editor de texto y en cualquier sistema operativo, y podrás abrirlo dentro de 50 años.
  • Puedes leer Markdown sin renderizarlo: A diferencia de RTF o HTML, Markdown es un formato legible en su forma cruda, no solo después de renderizarlo.
  • Markdown permite trabajar más rápido: Los escritores experimentados pueden dar formato al texto mientras escriben y trabajar más deprisa.
  • Markdown es universal: Como se ha mencionado antes, muchas plataformas usan Markdown de forma nativa.

Hoy en día, Markdown es importante para cualquiera que esté construyendo algo con herramientas de IA, porque los LLM generan Markdown por defecto.

Tabla de contenidos

  1. ¿Qué es Markdown?
  2. Por qué Markdown es importante
  3. Sintaxis básica de Markdown (encabezados, énfasis, listas, enlaces, imágenes, código, citas en bloque, saltos de línea, reglas horizontales, caracteres de escape)
  4. Sintaxis extendida de Markdown (tablas, código cercado, notas al pie, listas de tareas, tachado, IDs de encabezado, listas de definiciones, emoji, resaltado, subíndice/superíndice)
  5. Matriz de compatibilidad entre plataformas
  6. Markdown con sabor a GitHub (GFM)
  7. Markdown específico de cada plataforma (Discord, Slack, Reddit, Notion, Obsidian)
  8. Errores comunes de Markdown y cómo corregirlos
  9. Editores y herramientas de Markdown
  10. Resumen imprimible de la chuleta
  11. Preguntas frecuentes sobre Markdown

Sintaxis básica de Markdown

Estos elementos provienen de la especificación original de John Gruber de 2004. Todos los analizadores de markdown los soportan, con pequeñas diferencias de implementación indicadas más abajo.

Tabla de referencia rápida

Elemento Sintaxis Markdown
Encabezado Markdown # H1 ## H2 ### H3
Negrita Markdown **negrita** o __negrita__
Cursiva Markdown *cursiva* o _cursiva_
Negrita + cursiva ***negrita cursiva***
Cita en bloque Markdown > texto citado
Lista ordenada Markdown 1. Elemento
Lista desordenada - Elemento o * Elemento o + Elemento
Código en línea `código`
Bloque de código Sangrar 4 espacios, o usar bloques cercados
Regla horizontal --- o *** o ___
Enlace Markdown [texto](https://example.com)
Imagen Markdown ![texto alternativo](image.jpg)
Salto de línea Terminar una línea con dos espacios finales
Carácter de escape \*asterisco literal\*

Encabezados Markdown

Usa entre 1 y 6 almohadillas (#) seguidas de un espacio. El número de signos coincide con el nivel de encabezado en HTML.

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

La sintaxis alternativa (estilo Setext) funciona solo para H1 y H2:

Encabezado 1
============

Encabezado 2
------------

Buenas prácticas:

  • Pon siempre un espacio entre # y el texto del encabezado. #Encabezado funciona en algunos analizadores, pero falla en otros.
  • Usa solo un H1 por documento, normalmente el título de la página.
  • No te saltes niveles de encabezado. Ve de H1 → H2 → H3, no de H1 → H3.
  • Añade líneas en blanco antes y después de los encabezados para máxima compatibilidad.

Negrita, cursiva y énfasis en Markdown

**Esto es negrita** y __esto también es negrita__
*Esto es cursiva* y _esto también es cursiva_
***Negrita y cursiva*** combinadas

Se renderiza como:

Esto es negrita y esto también es negrita Esto es cursiva y esto también es cursiva Negrita y cursiva combinadas

Ojo: Algunos analizadores no manejan bien los guiones bajos en medio de una palabra. Para máxima compatibilidad, usa asteriscos para énfasis dentro de una palabra: in**creí**ble, no in__creí__ble.

Citas en bloque de Markdown

Empieza cualquier línea con > para crear una cita en bloque de markdown.

> Esta es una cita en bloque de una sola línea.

> Esta es una cita en bloque
> que ocupa varias líneas.

> Las citas en bloque pueden anidarse.
>
> > Como esta.
>
> Y pueden contener **otros elementos markdown**.

Las citas en bloque de Markdown funcionan bien para destacar citas, avisos y formatos de respuesta tipo correo electrónico.

Listas Markdown

Las listas desordenadas aceptan -, * o + indistintamente. Elige un estilo y manténlo por coherencia.

- Primer elemento
- Segundo elemento
- Tercer elemento
  - Elemento anidado (sangra dos o cuatro espacios)
  - Otro elemento anidado
- Cuarto elemento

Las listas ordenadas usan números seguidos de un punto:

1. Primer elemento
2. Segundo elemento
3. Tercer elemento

Truco útil: Los números no tienen que ser correctos. Markdown los renumera automáticamente:

1. Primero
1. Segundo
1. Tercero

…se renderiza igual que 1, 2, 3. Esto significa que puedes reordenar elementos sin renumerarlos.

Anidar listas ordenadas y desordenadas en markdown:

1. Primer paso
2. Segundo paso
   - Subviñeta
   - Otra subviñeta
3. Tercer paso
   1. Subpaso
   2. Otro subpaso

Elementos de lista con varios párrafos: Sangra la continuación con el mismo número de espacios, normalmente 4 o una tabulación:

1. Primer elemento

    Este párrafo pertenece al primer elemento.
    Fíjate en la línea en blanco de arriba y la sangría.

2. Segundo elemento

Enlaces Markdown

Los enlaces en línea son el estilo más común:

[Visitar Google](https://www.google.com)
[Con título al pasar el ratón](https://www.google.com "Página principal de Google")

Los enlaces markdown de estilo referencia son útiles cuando la misma URL aparece varias veces o cuando quieres mantener el texto limpio:

Me encantan [Obsidian][1] y [VS Code][vscode] para markdown.

[1]: https://obsidian.md
[vscode]: https://code.visualstudio.com

URLs automáticas. Envuelve una URL simple entre corchetes angulares:

<https://example.com>
<hello@example.com>

Enlaces relativos. Enlaza a archivos del mismo repositorio o carpeta:

[Lee la licencia](./LICENSE.md)
[Archivo del directorio padre](../README.md)

Enlaces ancla de Markdown. Salta a un encabezado en la misma página. La mayoría de analizadores generan IDs automáticamente a partir del texto del encabezado, en minúsculas y con guiones en lugar de espacios:

Salta a [la sección de instalación](#installation).

## Installation

Imágenes Markdown

La sintaxis de imagen en Markdown es la sintaxis de enlace con un signo de exclamación delante:

![Texto alternativo descriptivo](/path/to/image.jpg)
![Texto alternativo](/path/to/image.jpg "Título opcional al pasar el ratón")

Las imágenes markdown de estilo referencia funcionan igual que los enlaces de referencia:

![Logotipo de la empresa][logo]

[logo]: /images/logo.png "Nuestro logotipo"

Convertir una imagen markdown en un enlace:

[![Texto alternativo](image.jpg)](https://example.com)

Cambiar el tamaño de las imágenes. El markdown puro no tiene sintaxis para esto. Usa HTML en línea como solución alternativa:

<img src="image.jpg" alt="Texto alternativo" width="400">

Nota de accesibilidad: Escribe siempre un texto alternativo con sentido. Los lectores de pantalla dependen de él, y los motores de búsqueda lo usan para entender el contenido de la imagen. ![](logo.png) está mal; ![Logotipo de la empresa, círculo azul con una M blanca](logo.png) está bien.

Código Markdown

El código en línea en Markdown va entre comillas invertidas simples:

Instala con `npm install markdown-it`.

Bloques de código Markdown. Sangra cada línea con cuatro espacios o una tabulación:

    function hello() {
      console.log("Hello, world!");
    }

En la práctica, casi todo el mundo usa bloques de código cercados en su lugar, que se cubren en la sección de sintaxis extendida de más abajo, porque permiten resaltado de sintaxis.

Escapar comillas invertidas dentro del código en línea. Usa más comillas invertidas por fuera:

Para mostrar una comilla invertida, usa `` `backtick` `` así.

Reglas horizontales Markdown

Tres o más guiones, asteriscos o guiones bajos en su propia línea:

---
***
___

Los tres se renderizan igual. Pon líneas en blanco antes y después por compatibilidad.

Saltos de línea en Markdown

Esta es una de las características más confusas de markdown. Hay tres comportamientos distintos:

Salto de párrafo. Deja una línea en blanco entre textos:

Este es el párrafo uno.

Este es el párrafo dos.

Salto de línea duro (mismo párrafo). Termina una línea con dos espacios al final:

Esta línea termina con dos espacios.␣␣
Esta línea es un salto dentro del mismo párrafo.

Solución con HTML. Usa <br> cuando los espacios finales parezcan demasiado frágiles:

Esta línea tiene un salto HTML.<br>
Esta es la siguiente línea.

Por qué los espacios finales son polémicos: Son invisibles. La mayoría de editores los eliminan al guardar. GitHub Flavored Markdown (GFM) resuelve esto tratando cualquier salto de línea simple como un salto dentro de un párrafo, pero el CommonMark estándar exige los espacios finales.

Caracteres de escape en Markdown

Para mostrar un carácter que markdown normalmente interpretaría como formato, antepón una barra invertida:

\*Esto muestra asteriscos literales\*
\# Esto muestra una almohadilla literal
\[no es un enlace\]

Caracteres escapables: \ ` * _ {} [] () # + - . ! |

Sintaxis extendida de Markdown

Estos elementos no están en la especificación original de Gruber, pero la mayoría de procesadores markdown ampliamente usados los soportan, incluidos GitHub, GitLab, Reddit, Stack Overflow, Obsidian, Notion y Discord. La compatibilidad varía, así que revisa la matriz de más abajo antes de depender de cualquiera de ellos.

Tabla de referencia rápida

Elemento Sintaxis Markdown
Tabla Markdown | Encabezado | Encabezado | + | --- | --- |
Bloque de código cercado ```language ... ```
Resaltado de sintaxis Nombre del lenguaje tras la apertura del bloque
Nota al pie Aquí hay una nota.[^1] ... [^1]: Texto de la nota.
ID de encabezado ### Mi encabezado {#custom-id}
Lista de definiciones término nueva línea : definición
Tachado ~~texto eliminado~~
Lista de tareas - [x] Hecho - [ ] Pendiente
Shortcode de emoji :joy: :rocket:
Resaltado ==resaltado==
Subíndice H~2~O
Superíndice E = mc^2^
URL automática <https://example.com>
Alertas de GitHub Markdown > [!NOTE] > [!WARNING] > [!TIP]

Tablas Markdown

Usa barras verticales (|) para las columnas y una fila de guiones para separar el encabezado.

| Nombre   | Rol         | Ubicación     |
| -------- | ----------- | ------------- |
| Alice    | Desarrolla. | Berlín        |
| Bob      | Diseñador   | Montreal      |
| Carol    | Escritora   | Sídney        |

Alineación de columnas. Añade dos puntos a la fila separadora:

| Alineado a la izquierda | Centrado       | Alineado a la derecha |
| :---------------------- | :------------: | --------------------: |
| manzanas                | bananas        |                  $100 |
| cerezas                 | dátiles        |                   $12 |

Consejos que la mayoría de guías no mencionan:

  • No necesitas alinear las barras verticales en el fuente. El renderizador se encarga del espaciado.
  • Las barras exteriores son opcionales, pero añadirlas ayuda con la legibilidad y con los plugins del editor.
  • Puedes usar markdown básico dentro de las celdas (**negrita**, *cursiva*, `código`, enlaces).
  • No puedes usar elementos de bloque como encabezados, citas en bloque o listas dentro de las celdas.
  • Para contenido de varias líneas dentro de una celda, usa <br> en lugar de un salto de línea.
  • Para mostrar una barra vertical literal dentro de una celda, usa la entidad HTML &#124;.

Bloques de código cercados en Markdown

Tres comillas invertidas, o tildes, abren y cierran un bloque. Añade un identificador de lenguaje tras la apertura para el resaltado de sintaxis:

```python
def greet(name):
    return f"Hello, {name}!"

print(greet("world"))
```

Identificadores de lenguaje comunes: python, javascript, typescript, bash, shell, sql, json, yaml, html, css, rust, go, java, c, cpp, csharp, php, ruby, swift, kotlin, dart, r, scala, diff.

Mostrar cambios de código con diff:

```diff
- const old = "remove this";
+ const new = "add this";
```

Escapar triples comillas invertidas. Envuelve el bloque con cuatro comillas invertidas:

````
Este bloque contiene ```triple backticks``` dentro.
````

Notas al pie en Markdown

Las notas al pie son perfectas para citas, aclaraciones y notas explicativas sin recargar el texto principal.

Aquí hay una afirmación que necesita una fuente.[^1]

Aquí hay otra afirmación.[^nota-detallada]

[^1]: Esta es una nota al pie breve.
[^nota-detallada]: Las notas al pie con nombre siguen renderizándose como números, pero
    son más fáciles de seguir en el fuente. Pueden ocupar varias líneas si
    sangras la continuación.

IDs de encabezado en Markdown

Algunos analizadores te permiten asignar IDs personalizados a los encabezados para enlazarlos con precisión:

### Mi gran encabezado {#custom-heading-id}

Salta a [mi encabezado](#custom-heading-id).

GitHub y muchos otros generan IDs automáticamente a partir del texto del encabezado, así que normalmente no lo necesitas.

Listas de definiciones en Markdown

Markdown
: Un lenguaje de marcado ligero para dar formato a texto plano.

HTML
: El lenguaje de marcado estándar para páginas web.

CSS
: El lenguaje usado para dar estilo a documentos HTML.

El soporte es irregular. Funciona en Pandoc, PHP Markdown Extra y algunos otros, pero no en GFM estándar.

Tachado en Markdown

Envuelve el texto con dos tildes para tacharlo:

~~Este texto está tachado.~~

Se renderiza como: Este texto está tachado.

Funciona en GFM, Reddit, Discord, Slack y la mayoría de procesadores ampliamente usados. No en CommonMark estándar.

Listas de tareas en Markdown

Casillas interactivas, usadas normalmente en issues de GitHub, pull requests y tableros de proyecto:

- [x] Escribir el primer borrador
- [x] Editar para mejorar la claridad
- [ ] Publicar el artículo
- [ ] Promocionarlo en redes sociales
  - [ ] Twitter
  - [ ] LinkedIn
  - [ ] Hacker News

En GitHub se renderizan como casillas clicables que puedes alternar directamente en la interfaz.

Emoji en Markdown

La mayoría de plataformas soportan shortcodes de emoji:

Lánzalo :rocket: y celébralo :tada::champagne:

También puedes pegar directamente caracteres emoji reales. Se renderizan bien en cualquier archivo markdown porque al final solo son Unicode. 🚀🎉

Resaltado, subíndice y superíndice en Markdown

Necesito ==resaltar== esta idea importante.
El agua es H~2~O.
La famosa ecuación de Einstein: E = mc^2^.

El soporte es limitado. Funciona en Obsidian, MultiMarkdown y algunos analizadores extendidos, pero no en GFM.

Enlaces automáticos de URL en Markdown

Envuelve una URL entre corchetes angulares para crear un enlace automático:

<https://example.com>
<contact@example.com>

En GitHub Flavored Markdown, cualquier URL desnuda se convierte automáticamente. Ni siquiera necesitas los corchetes.

Matriz de compatibilidad entre plataformas

Usa esta tabla para comprobar qué elementos de sintaxis funcionan en las plataformas que utilizas. "Sí" significa soporte completo, "No" significa sin soporte y "Parcial" significa que la funcionalidad existe con limitaciones o usa una sintaxis no estándar.

Funcionalidad GFM GitLab Reddit Discord Slack Notion Obsidian Stack Overflow
Encabezados Sí Sí Sí No No Sí Sí Sí
Negrita / cursiva Sí Sí Sí Sí Parcial* Sí Sí Sí
Tachado Sí Sí Sí Sí Sí Sí Sí Sí
Cita en bloque Sí Sí Sí Sí Sí Sí Sí Sí
Listas Sí Sí Sí Sí Sí Sí Sí Sí
Código en línea Sí Sí Sí Sí Sí Sí Sí Sí
Código cercado Sí Sí Sí Sí Sí Sí Sí Sí
Resaltado sint. Sí Sí Parcial Parcial No Sí Sí Sí
Enlaces Sí Sí Sí Sí Parcial** Sí Sí Sí
Imágenes Sí Sí Parcial Parcial Parcial Sí Sí Sí
Tablas Sí Sí Sí No No Sí Sí Sí
Listas de tareas Sí Sí No No No Sí Sí No
Notas al pie Sí Sí No No No No Sí No
Shortcodes emoji Sí Sí No Sí Sí No Parcial No
Matemáticas Sí Sí No No No Sí Sí Sí
Diagramas Mermaid Sí Sí No No No No Sí No
Subrayado No No No Sí No Sí Parcial No
Texto spoiler No No Sí Sí No No No No

***** Slack usa un solo asterisco para negrita, no doble, y un solo guion bajo para cursiva. ****** Slack usa la sintaxis <url|texto> en lugar de los enlaces markdown estándar.

Markdown con sabor a GitHub (GFM)

GitHub Flavored Markdown (GFM) es el dialecto de markdown más influyente. Como GitHub es el hogar por defecto de los proyectos de código abierto, las convenciones de GFM se han convertido en el estándar de facto.

GFM añade lo siguiente sobre el markdown estándar:

Alertas de GitHub

Una sintaxis especial de cita en bloque para avisos. Se soportan cinco tipos:

> [!NOTE]
> Información útil que los usuarios deberían conocer.

> [!TIP]
> Consejo útil para hacer las cosas mejor.

> [!IMPORTANT]
> Información clave que los usuarios necesitan conocer.

> [!WARNING]
> Información urgente que requiere atención inmediata.

> [!CAUTION]
> Advierte sobre riesgos o resultados negativos.

Cada una se renderiza con un color y un icono distintos en GitHub.

Referencias autovinculadas de Markdown

Dentro de los repositorios de GitHub, ciertos patrones se convierten automáticamente en enlaces:

  • #123 → enlaza al issue o pull request #123
  • @username → menciona a un usuario
  • org/repo#123 → enlaza a un issue en otro repositorio
  • a1b2c3d → enlaza a un hash de commit

Diagramas Mermaid en Markdown

Los bloques de código cercados con mermaid como lenguaje se renderizan como diagramas de flujo, diagramas de secuencia y más:

```mermaid
graph LR
    A[Inicio] --> B{Decisión}
    B -->|Sí| C[Haz la cosa]
    B -->|No| D[Sáltatela]
```

Expresiones matemáticas en Markdown

GFM soporta matemáticas en LaTeX de dos formas:

Matemáticas en línea: $E = mc^2$

Matemáticas en bloque:

$$
\frac{n!}{k!(n-k)!} = \binom{n}{k}
$$

Markdown específico de cada plataforma

Markdown de Discord

Discord usa su propia variante de markdown. Diferencias clave frente al estándar:

  • __underline__ con doble guion bajo produce subrayado, no negrita
  • **bold** sigue funcionando
  • *italic* y _italic_ funcionan ambos
  • ||spoiler|| oculta texto hasta que se hace clic
  • # Heading funciona, pero solo se soportan H1, H2 y H3
  • Los bloques de código y el código en línea funcionan con normalidad
  • No hay tablas ni imágenes mediante sintaxis markdown

Markdown de Slack (mrkdwn)

La variante de markdown de Slack, llamada de forma un poco confusa "mrkdwn", se aparta bastante:

  • *bold* usa un solo asterisco, no doble
  • _italic_ usa un solo guion bajo
  • ~strikethrough~ usa una sola tilde
  • `code` funciona con normalidad
  • > quote funciona con normalidad
  • Los enlaces usan la sintaxis <https://example.com|texto del enlace>
  • No hay encabezados, tablas ni listas de tareas

Si pegas markdown estándar en Slack, no se formateará correctamente. Convierte antes.

Markdown de Reddit

Reddit soporta la mayor parte de la sintaxis estándar y extendida con algunas peculiaridades:

  • >!spoiler!< para texto spoiler
  • ^superscript con un acento circunflejo, sin necesidad de cierre para palabras únicas
  • Soporta tablas, tachado y bloques de código
  • No soporta listas de tareas, notas al pie ni IDs personalizados de encabezado

Markdown de Notion

Notion soporta entrada en markdown, pero la convierte a su sistema de bloques. Puedes escribir markdown para crear bloques rápidamente:

  • El markdown estándar funciona durante la escritura
  • Notion añade sus propias funciones, como bases de datos, toggles y callouts, que no son markdown estándar
  • Al pegar contenido markdown normalmente se importa bien

Markdown de Obsidian

Obsidian es una aplicación de notas que usa markdown, con varias extensiones:

  • [[Enlaces estilo wiki]] para enlaces internos entre notas
  • [[Nota#encabezado]] para enlazar a un encabezado concreto en otra nota
  • ![[Nota]] para incrustar el contenido de otra nota
  • > [!note] Título del callout para callouts de Obsidian, similares a las alertas de GitHub
  • Soporte completo para matemáticas LaTeX
  • Soporte completo para Mermaid

Errores comunes de Markdown

Incluso los escritores experimentados cometen estos errores en markdown. Esto es lo que conviene evitar y cómo hacerlo.

1. Falta de líneas en blanco alrededor de elementos de bloque en markdown

Las listas, encabezados, bloques de código y citas en bloque normalmente necesitan una línea en blanco antes y después. Sin ella, algunos analizadores los fusionan con el párrafo que los rodea.

Incorrecto:

Aquí hay un párrafo.
## Encabezado
Más texto.

Correcto:

Aquí hay un párrafo.

## Encabezado

Más texto.

2. Sangría inconsistente en listas markdown

Las listas anidadas necesitan una sangría consistente. Mezclar sangrías de dos y cuatro espacios, o mezclar tabulaciones y espacios, produce resultados impredecibles. Elige una opción y manténla.

3. Olvidar los espacios finales para los saltos de línea en markdown

Si quieres un salto de línea dentro de un párrafo pero tu texto aparece seguido, probablemente olvidaste los dos espacios finales. Esta es, con diferencia, la pregunta más común sobre markdown en Stack Overflow.

4. Rutas relativas de imágenes markdown que se rompen tras desplegar

![logo](images/logo.png) funciona en tu editor pero falla al desplegar en un subdirectorio. Usa rutas absolutas desde la raíz del sitio (/images/logo.png) o URLs completas para mayor portabilidad.

5. Usar comillas tipográficas de Word en bloques de código markdown

Cuando pegas código desde un documento que tiene comillas tipográficas, el código no funcionará cuando se copie. Pega siempre el código como texto plano en archivos markdown.

6. Mezclar HTML y markdown dentro del mismo bloque

El markdown dentro de etiquetas HTML de nivel de bloque muchas veces no se renderiza. Esto falla:

<div>
**Esta negrita no se renderizará.**
</div>

Arréglalo separándolo con líneas en blanco, o usando solo HTML en línea:

<div>

**Esta negrita sí se renderizará.**

</div>

7. Saltarse niveles de encabezado markdown

Pasar de H1 directamente a H3 reduce la accesibilidad y perjudica el SEO. Usa los niveles de encabezado de forma secuencial.

8. Usar guiones bajos dentro de palabras en markdown

un_believ_able produce cursiva en algunos analizadores y guiones bajos literales en otros. Usa asteriscos para el énfasis dentro de una palabra: un*believ*able.

Preguntas frecuentes sobre Markdown

¿Para qué se usa markdown?

Markdown se usa para documentación, como READMEs, documentación de API y wikis, publicaciones de blog, escritura técnica, toma de notas, mensajes de chat en plataformas como Discord y Slack, sitios web estáticos, libros electrónicos y cualquier lugar donde el formato en texto plano resulte útil. La mayoría de modelos de lenguaje grandes generan respuestas en markdown por defecto.

¿Markdown es igual en todas las plataformas?

No. La sintaxis básica, como encabezados, énfasis, listas, enlaces, código y citas en bloque, funciona casi en todas partes, pero las funciones extendidas como tablas, notas al pie, listas de tareas y matemáticas varían mucho entre plataformas. Mira la matriz de compatibilidad de arriba para más información.

¿Qué extensión de archivo usa markdown?

.md es la más común. También puedes ver .markdown, .mdown, .mkd o .mkdn. Todas son el mismo formato. El tipo MIME es text/markdown, registrado en la RFC 7763.

¿Puedo usar HTML dentro de markdown?

Sí. Casi todos los procesadores de markdown dejan pasar el HTML crudo a la salida. Así es como la gente añade funciones que markdown no soporta de forma nativa, como etiquetas <kbd> para teclas del teclado, <details> para secciones desplegables, <iframe> para incrustaciones y más.

¿Cómo convierto markdown a PDF, Word o HTML?

A HTML: Todos los procesadores de markdown lo hacen de forma nativa. Pandoc, markdown-it y marked son bibliotecas populares.

A PDF: Usa Pandoc (pandoc input.md -o output.pdf), la función de exportación de Typora o VS Code con la extensión Markdown PDF.

A Word (.docx): Pandoc lo gestiona bien con pandoc input.md -o output.docx.

¿Markdown soporta ecuaciones matemáticas?

No en la especificación original, pero muchos procesadores, como GitHub, GitLab, Obsidian, MkDocs, Jupyter y Notion, soportan matemáticas en LaTeX. Usa $...$ para matemáticas en línea y $$...$$ para ecuaciones en bloque.

¿En qué se diferencia markdown de HTML?

HTML usa etiquetas como <p>, <strong> y <a>, que son detalladas pero precisas. Markdown usa símbolos de puntuación rápidos de escribir y que siguen siendo legibles en texto plano. Todo archivo markdown acaba convirtiéndose a HTML para mostrarse. Markdown es un superconjunto de HTML. Siempre puedes insertar HTML dentro de un archivo markdown cuando necesitas algo que markdown no puede expresar.

¿Qué es CommonMark?

CommonMark es una especificación estandarizada de markdown, publicada en 2014 para resolver ambigüedades en la especificación original de Gruber. La mayoría de procesadores implementan CommonMark como base y luego añaden extensiones, como tablas o listas de tareas. GitHub Flavored Markdown es CommonMark más las extensiones de GitHub.

¿Markdown es gratis?

Sí. Markdown no es software. Es una especificación. Tanto la especificación original de Gruber como la de CommonMark están disponibles libremente. El propio nombre "Markdown" no está registrado como marca.

¿Cuánto se tarda en aprender markdown?

Lo básico, como encabezados, negrita, cursiva, enlaces y listas, se aprende en unos cinco minutos. Puedes escribir markdown útil en una hora. Dominar la sintaxis extendida y las variaciones específicas de cada plataforma lleva más tiempo, pero esta chuleta cubre casi todo lo que vas a necesitar.

¿Cuál es la diferencia entre markdown y texto enriquecido?

Los formatos de texto enriquecido, como .docx y .rtf, almacenan el formato como datos binarios o XML junto al texto. Markdown almacena el formato como símbolos visibles de texto plano. El intercambio es este: el texto enriquecido te da un control casi perfecto del aspecto a costa de la portabilidad; markdown te da portabilidad y velocidad a costa de un control más fino.