Lo básico en una tabla
Markdown se diseñó para que un archivo de texto se pueda leer bien incluso antes de convertirlo. Un encabezado parece un encabezado porque empieza con una almohadilla, y una lista parece una lista porque cada línea empieza con un guion. Cuando el texto se muestra en GitHub, en una aplicación de notas o en el editor de abajo, las marcas se convierten en formato real.
La tabla recoge las marcas que más vas a necesitar. Copia cualquier ejemplo en el editor para ver qué produce.
| Elemento | Escribe | Resultado |
|---|---|---|
| Encabezado de nivel 1 a 6 | # Título, ## Sección, ### Subsección | Encabezados de tamaño decreciente |
| Negrita | **negrita** o __negrita__ | texto en negrita |
| Cursiva | *cursiva* o _cursiva_ | texto en cursiva |
| Negrita y cursiva | ***ambas*** | texto en negrita y cursiva |
| Tachado | ~~precio anterior~~ | texto tachado |
| Código en línea | `npm install` | código en letra monoespaciada |
| Enlace | [Anyfeat](https://anyfeat.com) | texto en el que se puede hacer clic |
| Imagen |  | una imagen con texto alternativo |
| Lista con viñetas | - elemento (o * elemento, + elemento) | una viñeta |
| Lista numerada | 1. primero | un elemento numerado |
| Lista de tareas | - [ ] pendiente y - [x] hecho | casillas |
| Cita | > texto citado | una cita con sangría |
| Línea horizontal | *** en su propia línea | una línea divisoria |
Pruébalo aquí: Editor Markdown
Abrir la herramienta completaEncabezados, párrafos y saltos de línea
Empieza una línea con entre una y seis almohadillas seguidas de un espacio para crear un encabezado; el número de almohadillas es el nivel. La mayoría de los documentos usan un encabezado de nivel 1 para el título y encabezados de nivel 2 y 3 para las secciones. Olvidar el espacio después de la almohadilla es el error más habitual: #Título se queda como texto normal en GitHub.
Un párrafo es una o más líneas de texto separadas del párrafo siguiente por una línea vacía. Un salto de línea simple dentro de un párrafo se ignora al convertir el texto, algo que sorprende a mucha gente. Para forzar un salto de línea, termina la línea con dos espacios o con una barra invertida. Los comentarios de GitHub y algunas aplicaciones de chat tratan cada salto de línea como un salto; en el editor de arriba, activa Saltos de línea como en los comentarios de GitHub para obtener el mismo comportamiento.
En GitHub y en el editor de arriba, cada encabezado recibe también un ancla, una versión en minúsculas de su texto con los espacios cambiados por guiones. A un encabezado llamado Primeros pasos se puede enlazar con [ver instalación](#primeros-pasos), y así funcionan los índices de los archivos README.
Listas y listas de tareas
Las listas con viñetas empiezan cada línea con un guion, un asterisco o un signo más y un espacio. Las listas numeradas usan un número y un punto. Los números no tienen que ser correctos: una lista escrita como 1. 1. 1. se muestra igualmente como 1, 2, 3, pero el primer número cuenta, así que una lista que empieza por 3. empieza en 3.
Para anidar una lista, añade sangría a los elementos interiores para que queden alineados con el texto del elemento de arriba, es decir, dos espacios bajo un guion y tres bajo 1. Cuatro espacios también funcionan en la mayoría de las herramientas. Una línea vacía entre elementos crea una lista suelta con más espacio entre ellos; sin líneas vacías la lista queda compacta.
Las listas de tareas son una extensión de GitHub: escribe - [ ] para una tarea pendiente y - [x] para una terminada. Se convierten en casillas. En el editor de esta página puedes marcar una casilla en la vista previa y el [ ] de tu texto cambia a [x].
Enlaces, imágenes y referencias
Un enlace es el texto visible entre corchetes seguido de la dirección entre paréntesis: [Anyfeat](https://anyfeat.com). Un título que aparece al pasar el ratón va entre comillas después de la dirección. Una dirección entre los signos menor y mayor que, como <https://anyfeat.com>, se convierte en un enlace que muestra la propia dirección, y en GitHub las direcciones sueltas que empiezan por https:// o www. se enlazan solas.
Las imágenes usan el mismo patrón con un signo de exclamación delante: . El texto entre corchetes es el texto alternativo que leen los lectores de pantalla y que se muestra cuando la imagen no carga, así que describe lo que se ve en ella.
En documentos largos, los enlaces de referencia mantienen el texto legible: escribe [la guía][1] en el texto y pon [1]: https://example.com en su propia línea en cualquier parte del archivo. La línea de definición no aparece en el resultado.
Tablas
Las tablas forman parte de GitHub Flavored Markdown y funcionan en GitHub, GitLab, la mayoría de las herramientas de documentación y en el editor de arriba, pero no en todas las aplicaciones de Markdown. Escribe las celdas del encabezado separadas por barras verticales, luego una fila separadora con guiones y después una línea por fila:
| Plan | Precio |, después |:-|-:|, después | Equipo | 49 |. Cada celda de la fila separadora necesita al menos un guion; lo habitual son tres porque se leen mejor. Dos puntos a la izquierda de los guiones alinean la columna a la izquierda, dos puntos a ambos lados la centran y dos puntos a la derecha la alinean a la derecha, lo que va bien para los números.
No hace falta que las barras queden alineadas, y las barras de los extremos son opcionales. Para poner una barra vertical dentro de una celda, escríbela como \|. Markdown no permite saltos de línea dentro de una celda; usa <br> donde se admita HTML. El botón Tabla del editor inserta una tabla lista con tres columnas para que la rellenes.
Código y citas
Para un trozo corto de código dentro de una frase, enciérralo entre comillas invertidas simples: `git status`. Para varias líneas, pon tres comillas invertidas en la línea anterior y en la posterior al código. Un nombre de lenguaje justo después de las comillas de apertura, como js, python o sql, permite a GitHub y a los resaltadores colorear el código; el editor de esta página lo conserva como clase del elemento code en el HTML exportado. Las líneas con una sangría de cuatro espacios también se muestran como código.
Todo lo que está dentro del código se muestra tal como se escribió, así que es el lugar adecuado para símbolos que Markdown interpretaría de otro modo, como los asteriscos y los guiones bajos. Fuera del código, pon una barra invertida delante de un símbolo para mostrarlo tal cual: \* da un asterisco normal.
Las citas empiezan con > y pueden contener otro Markdown, incluidas listas y citas dentro de citas con >>. Se usan para citas textuales, notas y respuestas en conversaciones.
Diferencias entre aplicaciones de Markdown
La sintaxis básica de arriba funciona casi en todas partes. Las diferencias están en las extensiones: GitHub admite tablas, listas de tareas, tachado, enlaces automáticos y avisos escritos como > [!NOTE]; Obsidian añade enlaces entre notas con dobles corchetes; algunas herramientas admiten notas al pie y fórmulas matemáticas. El editor de esta página sigue a GitHub en tablas, listas de tareas, tachado, enlaces automáticos y anclas de encabezados, y no admite notas al pie, fórmulas ni avisos.
La mayoría de las aplicaciones de Markdown aceptan también algo de HTML. Etiquetas como <br>, <sub>, <sup>, <kbd> y <details> funcionan en el editor de arriba, mientras que los scripts, los estilos y los atributos de eventos se quitan siempre, igual que en GitHub.