Chuleta práctica de Markdown para documentos que compartir
Consulta esta chuleta de Markdown para títulos, énfasis, listas, enlaces, tablas, tareas y código y compara un ejemplo renderizado.
En esta página
01Empieza por un documento pequeño y completo02Entiende los signos por su funciónUna chuleta útil te ayuda a terminar un documento, no a memorizar todos los dialectos de Markdown. Abre la chuleta de Markdown mientras redactas y usa esta guía para comprobar la sintaxis habitual y su resultado visual. Se centra en los componentes comunes de un documento; las fórmulas y los diagramas requieren sus propias referencias.
Este ejemplo combina títulos, estilos de texto, lista, cita, enlace, tabla y tarea. Cópialo entero para ver cómo se relacionan las partes en lugar de probar símbolos por separado.
# Markdown field guide
## Inline text
**Bold**, *emphasis*, and `inline code`.
## Lists
- First item
- Second item
> A short quotation.
[Documentation](https://spec.commonmark.org/current/)
| Item | State |
|:--|:--|
| Draft | Reviewed |
- [x] GFM task list
La imagen exportada muestra la jerarquía visual. Guarda también el Markdown: allí siguen siendo editables el texto y los destinos de los enlaces, mientras que PNG es una copia visual.
- Secciones: usa
#,##y###seguidos de un espacio para títulos de nivel descendente. Elige el nivel por la estructura del documento, no por el tamaño que buscas en una tarjeta. - Significado en línea:
**bold**destaca una frase clave,*emphasis*aporta un énfasis más suave y los acentos graves protegen identificadores de código cortos. Evita poner párrafos enteros en negrita. - Listas: usa
-para viñetas o números con punto y espacio para pasos. Aplica sangría a los elementos secundarios. Las líneas vacías facilitan distinguir bloques en la fuente. - Citas: empieza las líneas citadas con
>. Si citas a otra persona, identifica la fuente en el texto cercano. - Enlaces e imágenes:
[label](URL)crea un enlace. Una imagen utiliza la misma estructura con una exclamación delante; el texto entre corchetes describe la imagen.
Las tablas, listas de tareas y tachados son extensiones GFM, no funciones garantizadas en cualquier renderizador Markdown. La especificación CommonMark y la especificación GFM distinguen las reglas básicas de las extensiones. Comprueba esas funciones en el destino real.
El segundo ejemplo añade una lista ordenada con un elemento anidado, asteriscos literales, una línea divisoria y un bloque de código cercado. La cerca exterior de cuatro acentos graves permite mostrar literalmente la interior de tres.
### A smaller section
1. Review the draft
- Check the facts
2. Export the result
~~Old wording~~ and \*literal asterisks\*.
---
```javascript
console.log("Ready");
```
El identificador de lenguaje tras una cerca ayuda a elegir el resaltado. No ejecuta el programa ni demuestra que el código sea correcto.
Tras revisar la sintaxis, pega el documento en el conversor Markdown. Elige un ancho donde se lean bien la línea más larga y la tabla. Inspecciona el archivo descargado además de la vista previa y añade los enlaces importantes al texto que lo acompaña: una imagen no tiene enlaces Markdown pulsables.
Ten a mano la chuleta interactiva. Para fallos concretos, consulta los errores comunes de Markdown; para ejemplos largos y cercas, sigue con la guía de bloques de código.