Una tabla con todos los signos de Markdown no sirve de nada, porque la mitad no la vas a usar jamás. Esto es lo otro: lo que escribes y lo que sale, lado a lado, ordenado por frecuencia real de uso.
Si llegaste sin saber qué es esto, empieza por qué es un archivo md y vuelve. Si ya lo sabes, esta página es para tenerla abierta al lado mientras escribes.
Lo que vas a usar el noventa por ciento del tiempo
Los títulos. Una almohadilla es el título grande, dos es una sección, tres una subsección. Rara vez hace falta bajar más:
# El título del documento
Un párrafo normal se escribe tal cual, sin nada delante.
## Una sección
### Una subsecciónEl título del documento
Un párrafo normal se escribe tal cual, sin nada delante.
Una sección
Una subsección
Va un espacio entre la almohadilla y la palabra. Sin ese espacio no se convierte en título, y es el error más común de los primeros días.
Listas y casillas
Un guion delante de cada línea y ya tienes una lista. Si además le pones corchetes, tienes tareas pendientes:
## Precios
- Corte: 8
- Corte y barba: 12
## Pendientes
- [x] elegir el nombre
- [ ] pedir la foto del local
- [ ] mandarle los horarios al contadorPrecios
- Corte: 8
- Corte y barba: 12
Pendientes
- elegir el nombre
- pedir la foto del local
- mandarle los horarios al contador
La casilla se marca cambiando el espacio por una equis. Esto es lo que más rinde de todo Markdown: una lista de pendientes que se escribe con el teclado, se lee sin programa y la entiende el agente sin explicársela.
Negrita, código y enlaces
Los tres adornos que valen la pena. Dos asteriscos a cada lado para la negrita, dos tildes francesas para nombrar un archivo o un comando, y corchetes con paréntesis para un enlace:
La página está en **un solo archivo**.
Se abre con doble clic en `index.html`.
El número de WhatsApp se cambia al final de `index.html`.La página está en un solo archivo.
Se abre con doble clic en index.html.
El número de WhatsApp se cambia al final de index.html.
La tilde francesa se pone con Alt+] en el teclado español de Mac, y en Windows suele estar en la tecla de al lado del 1. Se usa para cualquier cosa que se escriba tal cual: un nombre de archivo, un comando, un número de teléfono.
Lo que no vas a necesitar
Markdown tiene tablas, notas al pie, citas, imágenes, bloques de código con el nombre del lenguaje y unas cuantas cosas más. Todo eso existe y está bien, pero si estás escribiendo las notas de tu proyecto no te hace falta ninguna.
La prueba es sencilla: con títulos, listas, casillas, negrita y código puedes escribir un README completo y las notas de cualquier proyecto. El día que te falte algo, lo buscas ese día. Aprender ahora la especificación entera es aprender de memoria cosas que no vas a usar.
Y si viniste con otra pregunta
Esta chuleta es el centro de un claro: un puñado de respuestas sueltas al mismo tema, sin orden ni requisitos. Si te trajo hasta aquí una pregunta distinta, seguramente esté abajo.
El claro de Markdown
Cinco respuestas al mismo tema, cada una por su lado. No hay orden ni requisitos: entra por la que te trajo hasta aquí y sal cuando tengas lo que buscabas.
- Por qué la IA lee Markdown y no Word
- Cómo crear un archivo md y con qué se abre
- Qué es un README.md y para qué sirve
- Convertir un archivo md a PDF o a Word
- La chuleta de Markdown, en una pantalla — estás aquí
Y algo que se usa más de lo que parece: la ventana del asistente que dibuja menús y cajas dentro de la terminal tiene nombre propio, y está explicado en qué es un TUI.
¿Para qué estás usando Markdown?
🌱 ¡Gracias! Tu respuesta quedó sembrada en la jungla. Cuando publiquemos ese contenido, los suscriptores se enteran primero:
