Guía rápida de Markdown
Todos los elementos de Markdown con un ejemplo que puedes editar: cambia el texto de la izquierda y el resultado renderizado se actualiza al instante a la derecha. Incluye la sintaxis básica, GitHub Flavored Markdown (tablas, listas de tareas, tachado) y extras de GitHub como alertas y notas al pie.
Última actualización:
Edita cualquier ejemplo: la vista previa se actualiza mientras escribes y tus cambios se guardan en este navegador. Las etiquetas muestran dónde funciona la sintaxis.
Ningún elemento de Markdown coincide con tu búsqueda. Prueba con "lista", "código" o "enlace".
Cómo usar Guía rápida de Markdown
- Encuentra el elemento que necesitas buscando (tabla, imagen, nota al pie) o eligiendo una pestaña como Básico o Extras de GitHub.
- Edita el ejemplo en el cuadro de Markdown. La vista previa de al lado se actualiza mientras escribes.
- Mira la etiqueta para saber dónde funciona la sintaxis: Básico funciona en cualquier app de Markdown, GFM en renderizadores tipo GitHub y Solo GitHub únicamente en GitHub.
- Copia el Markdown en tu README, documentación o notas, o copia el HTML resultante.
- Restablece un ejemplo para recuperar el original después de experimentar.
Referencia rápida de Markdown
| Elemento | Markdown | Compatibilidad |
|---|---|---|
| Encabezado | # H1 · ## H2 · ### H3 | En todas partes |
| Negrita / cursiva | **negrita** · *cursiva* · ***ambas*** | En todas partes |
| Enlace | [texto](https://example.com) | En todas partes |
| Imagen |  | En todas partes |
| Lista con viñetas | - elemento | En todas partes |
| Lista numerada | 1. elemento | En todas partes |
| Cita | > cita | En todas partes |
| Código en línea | `código` | En todas partes |
| Bloque de código | ```js … ``` | GFM / CommonMark |
| Línea horizontal | --- | En todas partes |
| Tabla | | A | B | + | --- | --- | | GFM |
| Lista de tareas | - [ ] pendiente · - [x] hecho | GFM |
| Tachado | ~~texto~~ | GFM |
| Nota al pie | texto[^1] + [^1]: nota | GitHub, muchos generadores de sitios estáticos |
| Alerta | > [!NOTE] | GitHub, algunas herramientas de documentación |
Comparación de variantes de Markdown
El Markdown original (John Gruber, 2004) definió lo básico, pero dejó abiertos muchos casos límite, así que los primeros renderizadores no coincidían. CommonMark (2014) es una especificación estricta y sin ambigüedades de esa sintaxis básica, con un amplio conjunto de pruebas. GitHub Flavored Markdown (GFM) es un superconjunto de CommonMark que añade tablas, listas de tareas, tachado, enlaces automáticos ampliados y filtrado de HTML inseguro. Después, cada plataforma añade sus propios extras: GitHub admite alertas, notas al pie, códigos de emoji, diagramas Mermaid y fórmulas LaTeX con $…$; herramientas como Obsidian añaden enlaces wiki ([[Página]]) y resaltados (==texto==). Cuando un documento debe verse igual en todas partes, limítate a los elementos Básico y GFM.
Consejos para un Markdown limpio
- Deja una línea en blanco antes y después de encabezados, listas, bloques de código y tablas; muchos renderizadores lo exigen.
- Pon siempre un espacio después de
#en los encabezados:#Encabezadono es un encabezado en CommonMark. - Usa un único estilo de forma coherente:
-para viñetas,**para negrita y*para cursiva. - Añade un lenguaje después de las comillas invertidas de apertura (
```python) para que el código se resalte. - Escribe un texto alternativo significativo para las imágenes; los lectores de pantalla lo leen en voz alta.
Preguntas frecuentes
¿Qué es Markdown?
Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Das formato a texto plano con símbolos sencillos, como # para encabezados y ** para negrita, y un renderizador lo convierte en HTML. Se usa en archivos README, documentación, foros, apps de chat y herramientas para tomar notas.
¿Qué es GitHub Flavored Markdown (GFM)?
GFM es la especificación de Markdown de GitHub, basada en CommonMark. Añade tablas, listas de tareas, tachado con ~~, enlaces automáticos para URL y reglas más estrictas para el HTML sin procesar. La mayoría de las herramientas modernas, como GitLab, VS Code y muchos generadores de sitios estáticos, lo admiten.
¿Cómo hago un salto de línea en Markdown?
La mayoría de los renderizadores ignoran un salto de línea simple dentro de un párrafo. Termina la línea con dos espacios o una barra invertida para forzar un salto de línea, o deja una línea en blanco para empezar un párrafo nuevo. Los comentarios e issues de GitHub son una excepción: allí un salto de línea simple se convierte en un salto.
¿Cómo creo una tabla en Markdown?
Escribe la fila de encabezado separada por barras verticales, luego una fila separadora de guiones como | --- | --- | y después una fila por línea. Añade dos puntos en el separador para alinear una columna: :--- a la izquierda, :---: al centro y ---: a la derecha. Las tablas forman parte de GFM, no del Markdown original.
¿Cómo añado una casilla de verificación en Markdown?
Empieza un elemento de lista con - [ ] para una casilla sin marcar o - [x] para una marcada. Estas listas de tareas son una función de GFM; en GitHub puedes marcarlas directamente en issues y pull requests.
¿Cómo escapo caracteres de Markdown?
Pon una barra invertida antes del carácter, por ejemplo \* para mostrar un asterisco literal o \# al principio de una línea para evitar un encabezado. Los caracteres que se pueden escapar incluyen \ ` * _ { } [ ] ( ) # + - . ! y |.
¿Puedo usar HTML dentro de Markdown?
Sí, la mayoría de los renderizadores dejan pasar HTML sencillo, lo que es útil para cosas que Markdown no tiene, como <kbd>, <sup>, <details> o el tamaño de las imágenes. Plataformas como GitHub eliminan scripts, estilos y muchos atributos por seguridad, así que limítate a etiquetas básicas.
¿Se prueban todas las herramientas de FreeToolCabin para comprobar su calidad y precisión?
Sí. Cada herramienta del sitio pasa pruebas automáticas en navegadores reales para comprobar que el resultado es correcto y que no hay errores. Si encuentras un fallo o tienes una sugerencia, escríbenos a [email protected] y lo revisaremos.