Sintaxis Básica de Markdown
La sintaxis básica de Markdown se compone de un conjunto reducido de símbolos intuitivos que permiten estructurar encabezados, párrafos, énfasis tipográfico y saltos de línea de forma instantánea.
1. Encabezados Jerárquicos #
Los encabezados se generan anteponiendo el carácter almohadilla (#) seguido obligatoriamente de un espacio. Markdown soporta 6 niveles jerárquicos, correspondientes a las etiquetas HTML <h1> hasta <h6>:
1 # Encabezado Nivel 1 (Equivalente a <h1>) 2 ## Encabezado Nivel 2 (Equivalente a <h2>) 3 ### Encabezado Nivel 3 (Equivalente a <h3>) 4 #### Encabezado Nivel 4 (Equivalente a <h4>) 5 ##### Encabezado Nivel 5 (Equivalente a <h5>) 6 ###### Encabezado Nivel 6 (Equivalente a <h6>)
Regla de oro: Por buenas prácticas de accesibilidad y SEO, cada documento debe contener un único encabezado
#de nivel 1, utilizando##y###para las secciones internas.
2. Párrafos y Saltos de Línea #
- Nuevo Párrafo: Se crea dejando una línea en blanco completa entre dos bloques de texto.
- Salto de Línea Simple (
<br>): Si escribes texto en la línea siguiente sin dejar una línea en blanco, la mayoría de parsers los unirán en un solo párrafo. Para forzar un salto de línea dentro del mismo párrafo, añade dos espacios al final de la línea antes de pulsar Enter.
1Este es el primer párrafo de texto. 2 3Este es un segundo párrafo separado por una línea en blanco. 4Esta línea tiene dos espacios al final 5y continúa aquí mismo como un salto simple.
- Resultado visual:
Este es el primer párrafo de texto.
Este es un segundo párrafo separado por una línea en blanco.
Esta línea tiene dos espacios al final
y continúa aquí mismo como un salto simple.
3. Énfasis Tipográfico y Formato de Texto #
| Estilo | Sintaxis Markdown | Equivalente HTML | Ejemplo Renderizado |
|---|---|---|---|
| Negrita | **texto** o __texto__ | <strong> | Texto en negrita |
| Cursiva | *texto* o _texto_ | <em> | Texto en cursiva |
| Negrita y Cursiva | ***texto*** o ___texto___ | <strong><em> | Negrita y cursiva |
~~texto~~ | <del> |
Ejemplo Combinado: #
1El framework **React** permite crear interfaces de usuario *declarativas* y ***altamente reactivas***. 2La versión ~~16.0~~ está desfasada; utiliza **React 19**.
- Resultado visual:
El framework React permite crear interfaces de usuario declarativas y altamente reactivas.
La versión 16.0 está desfasada; utiliza React 19.
Laboratorio: aprende editando Markdown #
Escribe y observa cómo los espacios, las líneas en blanco y los delimitadores
cambian el resultado. Los ejemplos de tablas, tareas y código te permiten probar
también la sintaxis que verás en los siguientes temas.
Laboratorio interactivo
Markdown: escribe y comprueba el resultado
Edita la fuente y observa la vista previa en directo. Experimenta con encabezados, listas, tablas, citas, notas al pie y bloques de código.
Vista previa
Mi primera página
Un texto con negrita, cursiva y tachado.
Ideas
- Aprender
- Experimentar
109/4000 caracteres · Markdown con tablas, tachado y tareas (GFM). El HTML escrito se muestra como texto; las imágenes se representan por su descripción y los enlaces son una vista previa visual.
Experimenta: Quita el espacio después de # y observa el encabezado. Une dos párrafos sin línea en blanco. Crea una tabla y añade otra fila; después cierra un bloque de código que hayas dejado abierto.
Resumen del tema
Conceptos clave #
- Encabezados Jerárquicos: desde
#(<h1>) hasta######(<h6>), siempre seguidos de un espacio. - Párrafos y Saltos: los párrafos requieren una línea en blanco de separación; dos espacios al final de una línea fuerzan un salto de línea (
<br>). - Estilos de Texto y Énfasis:
- Negrita:
**texto**o__texto__(<strong>). - Cursiva:
*texto*o_texto_(<em>). Tachado:~~texto~~(<del>).
- Negrita:
Qué debes recordar #
Los encabezados # estructuran el documento jerárquicamente, y los asteriscos (*, **) o tildes (~~) aplican formato tipográfico básico de forma inmediata.