Hoja de Referencia de Markdown
Referencia rápida de sintaxis Markdown — encabezados, listas, enlaces, bloques de código, tablas y más, con vistas previas renderizadas en tiempo real.
Cómo Usar
- Navega por la tabla de contenidos de la izquierda para saltar a cualquier categoría de sintaxis.
- Cada tarjeta muestra la sintaxis Markdown en bruto a la izquierda y el resultado renderizado a la derecha.
- Haz clic en el botón Copiar de cualquier tarjeta para copiar el fragmento al portapapeles.
- Úsalos directamente en GitHub, Notion, VS Code, Obsidian o cualquier editor Markdown.
Preguntas Frecuentes
-
¿Qué es Markdown?
Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Permite escribir texto formateado usando símbolos de texto plano — por ejemplo, rodear texto con ** lo pone en negrita. Los archivos Markdown son convertidos a HTML por los renderizadores utilizados en GitHub, plataformas de blogs, herramientas de documentación y aplicaciones de notas.
-
¿Es Markdown igual en todas partes?
La sintaxis base es bastante consistente, pero diferentes plataformas admiten diferentes extensiones. GitHub Flavored Markdown (GFM) añade listas de tareas, tachado y tablas. Obsidian admite wikilinks. Algunas plataformas usan CommonMark como estándar. Esta hoja de referencia se centra en las características más ampliamente admitidas.
-
¿Cómo hago un salto de línea en Markdown?
Termina una línea con dos espacios y presiona Enter para crear un salto de línea suave. Para un salto de párrafo, deja una línea en blanco entre dos líneas. En muchos renderizadores, un salto de línea simple sin espacios finales se trata como un espacio, no como un salto.
-
¿Puedo usar HTML dentro de Markdown?
La mayoría de los renderizadores Markdown permiten HTML en línea. Por ejemplo, puedes usar <br> para un salto de línea, <u>texto</u> para subrayado, o <details> para secciones plegables. Sin embargo, el soporte varía — algunos renderizadores orientados a la seguridad eliminan el HTML por completo.
¿Qué es Markdown?
Markdown es una sintaxis de texto plano que se convierte a HTML. Creado por John Gruber en 2004, fue diseñado para ser legible tal como está — el texto sin procesar debería parecer texto formateado incluso sin renderizar. Hoy se usa en todas partes: READMEs de GitHub, documentación técnica, plataformas de blogs, aplicaciones de toma de notas como Obsidian y Notion, y herramientas de chat como Slack y Discord.
La idea central es simple: usar caracteres ordinarios para indicar formato. Un # antes de una línea la convierte en encabezado. Rodear texto con ** lo pone en negrita. Indentar una línea con cuatro espacios la convierte en un bloque de código.
Cómo Ayuda una Hoja de Referencia de Markdown
Incluso los escritores experimentados olvidan ocasionalmente la sintaxis exacta para alinear columnas en una tabla, anidar listas o crear bloques de código con resaltado de sintaxis. Esta hoja de referencia sirve como búsqueda rápida.
Esta hoja cubre:
- Encabezados — cuatro niveles desde h1 hasta h4
- Formato de texto — negrita, cursiva, tachado, código en línea, hipervínculos
- Listas — ordenadas, desordenadas, anidadas y listas de tareas
- Enlaces e imágenes — enlaces en línea, enlaces con título, imágenes
- Citas — simples y anidadas
- Bloques de código — delimitados con opción de idioma para resaltado de sintaxis
- Tablas — con opciones de alineación de columnas
- Reglas horizontales — como separadores visuales
Dialectos de Markdown
CommonMark es una especificación estandarizada que resuelve ambigüedades en la especificación original. GitHub, GitLab, Discourse y muchas otras plataformas siguen CommonMark o algo parecido.
GitHub Flavored Markdown (GFM) añade listas de tareas (- [x]), tachado (~~texto~~), tablas y autoenlaces. La mayoría de las plataformas de código admiten GFM o un superconjunto de este.
Para la escritura técnica cotidiana — READMEs, documentación, publicaciones de blog, notas — CommonMark estándar más las extensiones GFM cubre prácticamente todo lo que necesitas.
Consejos para Escribir Buen Markdown
Sé consistente con los marcadores de lista. Elige - o * para listas desordenadas y mantente en esa opción. Mezclarlos es válido pero más difícil de leer en forma bruta.
Usa líneas en blanco entre elementos de bloque. Una línea en blanco antes y después de encabezados, bloques de código y citas garantiza una representación correcta en diferentes analizadores.
Prefiere bloques de código delimitados sobre los indentados. Los bloques con triples comillas permiten especificar el lenguaje para resaltado de sintaxis y son visualmente más claros en el origen.
Usa texto de enlace descriptivo. [Haz clic aquí](url) es peor que [Especificación de Markdown](url) tanto para la legibilidad como para la accesibilidad.