Guía rápida de sintaxis Markdown
Busca el elemento que necesitas, copia el ejemplo y comprueba cómo se renderiza. La guía distingue la sintaxis básica de las extensiones de GFM.
Markdown en un minuto
Markdown usa signos sencillos para dar estructura a un texto. Usa # para los títulos, ** para la negrita, - para las listas y corchetes con paréntesis para los enlaces. Las tablas, las tareas y el texto tachado dependen de GFM u otra extensión compatible.
Cómo usar esta guía
- 1Busca el tipo de formato en la referencia rápida.
- 2Copia la sintaxis y sustituye el texto del ejemplo.
- 3Pruébala en el editor y revisa la vista previa.
Sintaxis Markdown de uso habitual
Copia un ejemplo y sustituye el texto por tu propio contenido.
| Uso | Sintaxis | Resultado | Copiar |
|---|---|---|---|
| Título 1 | # Título 1 | Título 1 | |
| Título 2 | ## Título 2 | Título 2 | |
| Negrita | **texto en negrita** | texto en negrita | |
| Cursiva | *texto en cursiva* | texto en cursiva | |
| TachadoGFM | ~~texto eliminado~~ | ||
| Enlace | [ilovemd](https://ilovemd.net) | ilovemd | |
| Imagen |  | imagen con texto alternativo | |
| Lista con viñetas | - Primer elemento | • Primer elemento | |
| Lista numerada | 1. Primer paso | 1. Primer paso | |
| Lista de tareasGFM | - [ ] Redactar artículo | ☐ Redactar artículo | |
| Cita | > Texto citado | Texto citado | |
| Código en línea | `npm run build` | npm run build | |
| Bloque de código | ```js
console.log("Hola");
``` | bloque de código | |
| TablaGFM | | A | B |
|---|---|
| 1 | 2 | | tabla de dos columnas | |
| Línea horizontal | --- | línea divisoria | |
| Salto de línea | Línea uno
Línea dos | dos líneas | |
| Carácter escapado | \*no es cursiva\* | *no es cursiva* |
Títulos
Usa los títulos para expresar la jerarquía del documento, no solo para agrandar el texto. Lo habitual es tener un único H1, secciones H2 y subsecciones H3.
# Guía del proyecto
## Instalación
### macOS
### WindowsNegrita, cursiva y tachado
Destaca solo las palabras que ayudan a entender o recorrer el texto. El tachado es una extensión de GFM y puede no funcionar en todos los editores.
**Texto importante**
*Texto con énfasis*
***Negrita y cursiva***
~~Texto eliminado~~Listas y tareas
Usa guiones para elementos sin orden y números para pasos. Las casillas de tareas forman parte de GFM; comprueba si el destino las admite.
1. Instalar el paquete
2. Actualizar la configuración
3. Ejecutar la compilación
- [x] Escribir el borrador
- [ ] Revisar los enlaces
- [ ] Publicar la páginaEnlaces e imágenes
El texto de un enlace debe explicar adónde lleva. En una imagen, el texto alternativo debe describir la información o la función, no repetir el nombre del archivo.
Abre el [conversor de Markdown a PDF](/es/markdown-to-pdf).
Código en línea y bloques de código
Usa un acento grave para comandos o nombres de archivo. Para varias líneas, abre y cierra con tres acentos graves y añade el lenguaje si necesitas resaltado.
Ejecuta `npm run build` antes de publicar.
```javascript
const mensaje = "Hola, Markdown";
console.log(mensaje);
```Tablas y alineación
Mantén las celdas breves. En la fila separadora, coloca dos puntos a la izquierda, a ambos lados o a la derecha para controlar la alineación.
| Formato | Editable | Uso principal |
| :--- | :---: | ---: |
| DOCX | Sí | Colaboración |
| PDF | No | Compartir |
| HTML | Sí | Publicación |Saltos de línea y caracteres escapados
Un salto normal puede seguir dentro del mismo párrafo. Añade dos espacios al final de una línea para forzar un salto, una línea vacía para crear otro párrafo y una barra invertida para mostrar signos literales.
Primera línea con salto.
Segunda línea.
Nuevo párrafo.
\*Estos asteriscos se muestran.\*CommonMark y GitHub Flavored Markdown
Las implementaciones comparten una base, pero las extensiones no son universales. Revisa el editor, CMS o repositorio donde publicarás el contenido.
Títulos, párrafos, énfasis, citas, listas, código, enlaces, imágenes y líneas horizontales forman la base portátil que admiten los analizadores compatibles con CommonMark.
GitHub Flavored Markdown añade tablas, listas de tareas, texto tachado y autolinks ampliados. Otros editores pueden admitir todas, algunas o ninguna de estas extensiones.
Para consultar las reglas exactas, utiliza la especificación de CommonMark y la especificación de GitHub Flavored Markdown. CommonMark · GFM
Errores frecuentes
Si el formato no aparece como esperabas, revisa primero la estructura y después la compatibilidad del destino.
- Deja una línea vacía antes de listas, tablas y bloques de código.
- Cierra todos los marcadores de énfasis y los bloques de código.
- Añade una fila separadora debajo del encabezado de una tabla.
- Usa una sangría coherente en las listas anidadas.
- Comprueba si el destino admite las extensiones de GFM.
- Conserva rutas de imagen válidas y escribe un texto alternativo útil.
Preguntas sobre la sintaxis Markdown
¿La sintaxis Markdown funciona igual en todas partes?
La sintaxis básica es bastante estable. Las tablas, las tareas y el texto tachado dependen de GFM u otra extensión compatible.
¿Cómo se crea una tabla Markdown?
Escribe una fila de encabezados, una fila separadora con guiones y las filas de datos. También puedes crearla a partir de CSV o TSV con el generador de tablas.
¿Cómo puedo comprobar el resultado?
Copia el ejemplo en el editor de ilovemd y abre la vista previa enriquecida para ver el contenido renderizado.
¿Qué extensión debe tener un archivo Markdown?
La extensión más habitual es .md. Algunas aplicaciones también reconocen .markdown, pero .md suele ofrecer mejor compatibilidad.
¿Cómo evito que un signo active el formato?
Escribe una barra invertida antes del signo, por ejemplo \*texto\*, para mostrar los asteriscos sin convertir el texto en cursiva.