Código en línea en Markdown: el acento grave
Cómo marcar código dentro de un párrafo en Markdown usando acentos graves, escapar acentos dentro del propio código y cuándo conviene usar código en línea en lugar de un bloque.
Cuando mencionas un comando, un nombre de archivo o una variable dentro de una frase, marcarlo como código evita ambigüedades y hace el texto mucho más fácil de leer.
Sintaxis
Envuelve el texto entre acentos graves `:
Ejecuta `npm install` antes de arrancar el proyecto.Ejecuta
npm installantes de arrancar el proyecto.
Genera una etiqueta <code> en HTML, que los navegadores muestran en tipografía monoespaciada.
Dónde está el acento grave
En el teclado español está a la izquierda de la tecla 1, compartida con º y ª. Es una tecla muerta: al pulsarla no aparece nada hasta que pulses otra tecla. Para escribir un acento grave suelto, púlsala y después la barra espaciadora.
⚠️ No lo confundas con la comilla simple ' ni con el acento agudo ´. Son caracteres distintos y solo el acento grave funciona.
Lo que va dentro no se interpreta
Esta es la propiedad más útil del código en línea: todo lo que escribas dentro sale literal.
El texto `**esto no se pone en negrita**` conserva los asteriscos.El texto
**esto no se pone en negrita**conserva los asteriscos.
Es la forma más rápida de mostrar sintaxis Markdown dentro de un texto Markdown, sin tener que escapar carácter por carácter.
Tampoco se interpretan los enlaces, las listas ni las entidades HTML:
`<script>alert('hola')</script>`
<script>alert('hola')</script>
Acentos graves dentro del código
¿Y si el propio código contiene un acento grave? Entonces usa dos acentos graves como delimitadores:
Usa ``la plantilla `${nombre}` `` para interpolar.Usa
la plantilla `${nombre}`para interpolar.
La regla general: los delimitadores deben tener más acentos graves que la secuencia más larga que aparezca dentro. Con tres dentro, usa cuatro fuera.
Además, si el contenido empieza o acaba con un acento grave, añade un espacio justo después de la apertura y antes del cierre. Markdown se lo come al procesar:
`` `codigo` ``
`codigo`
Cuándo usar código en línea y cuándo un bloque
| Situación | Usa |
|---|---|
| Un comando en mitad de una frase | Código en línea |
| Un nombre de archivo o carpeta | Código en línea |
| Una variable, función o clase | Código en línea |
Un valor concreto (true, 404) | Código en línea |
| Dos o más líneas de código | Bloque de código |
| Cualquier cosa que quieras resaltar por lenguaje | Bloque de código |
La frontera práctica: si necesitas saltos de línea o resaltado de sintaxis, es un bloque. Para todo lo demás, código en línea.
Un uso muy común: teclas
Es habitual marcar los atajos de teclado como código:
Pulsa `Ctrl` + `C` para copiar.Pulsa
Ctrl+Cpara copiar.
Semánticamente lo correcto sería la etiqueta HTML <kbd>, que existe precisamente para eso y muchas plataformas estilizan como una tecla real:
Pulsa <kbd>Ctrl</kbd> + <kbd>C</kbd> para copiar.Pulsa Ctrl + C para copiar.
Ambas se usan; <kbd> es más precisa.
Errores frecuentes
Usar comillas simples. 'esto' no genera código. Tiene que ser el acento grave.
Abrir y no cerrar. Un acento grave suelto aparece como carácter literal. Suele pasar al escribir contracciones o al copiar y pegar.
Esperar formato dentro. Nada se interpreta dentro del código en línea, ni negrita ni enlaces. Si necesitas un enlace que parezca código, ponlo al revés: `texto` — el código va dentro del enlace.
Meter código muy largo en línea. Si no cabe en la línea, se desborda o se parte de forma fea. Pásalo a bloque.
Compatibilidad
El código en línea con un acento grave funciona en todas partes: Markdown original, CommonMark, GFM, Discord, Slack, Reddit, Notion, Obsidian. Es, junto a la negrita y la cursiva, la parte más universalmente soportada del lenguaje.
Pruébalo
Comprueba tus delimitadores en el previsualizador de Markdown, especialmente si estás anidando acentos graves.