Bloques de Código y Resaltado de Sintaxis
Markdown es la herramienta predilecta de los desarrolladores gracias a su soporte nativo para fragmentos de código en línea y bloques de código vallados (fenced code blocks) con resaltado léxico.
1. Código en Línea (Inline Code) #
Para resaltar nombres de variables, comandos de terminal o rutas de archivos dentro de un párrafo, enciérralos entre comillas invertidas simples (`):
1Para iniciar el proyecto, ejecuta `npm start` en tu terminal. 2La variable `PORT` debe definirse en el archivo `.env`.
- Resultado visual:
Para iniciar el proyecto, ejecuta npm start en tu terminal.
La variable PORT debe definirse en el archivo .env.
2. Bloques de Código Vallados (Fenced Code Blocks) #
Para incluir programas o scripts de varias líneas, se utilizan tres comillas invertidas (```) antes y después del bloque:
1``` 2function saludar() { 3 console.log("Hola, mundo"); 4} 5```
- Resultado visual:
function saludar() {
console.log("Hola, mundo");
}3. Resaltado de Sintaxis (Syntax Highlighting) #
Indicando el identificador del lenguaje de programación inmediatamente después de los tres backticks iniciales, el parser coloreará palabras clave, tipos, cadenas y comentarios:
1```typescript 2interface Usuario { 3 id: number; 4 nombre: string; 5 esAdmin: boolean; 6} 7 8const crearUsuario = (datos: Usuario): string => { 9 return `Usuario ${datos.nombre} registrado con éxito`; 10}; 11```
- Resultado visual:
1interface Usuario { 2 id: number; 3 nombre: string; 4 esAdmin: boolean; 5} 6 7const crearUsuario = (datos: Usuario): string => { 8 return `Usuario ${datos.nombre} registrado con éxito`; 9};
Identificadores de Lenguajes Más Comunes: #
- Web / Backend:
javascript,typescript,python,java,go,rust,csharp,php - Marcado y Estilos:
html,css,json,yaml,xml,sql,graphql - Terminal / DevOps:
bash,sh,dockerfile,diff,powershell
Resumen del tema
Conceptos clave #
- Código en Línea (Inline Code): backticks individuales
`variable`para resaltar comandos, palabras clave o rutas dentro de un párrafo (<code>). - Bloques de Código Vallados (Fenced Code Blocks): triples backticks
```antes y después del bloque (<pre><code>). - Resaltado de Sintaxis (Syntax Highlighting): especificación del identificador de lenguaje (ej.
```js,```python,```bash) en la primera línea del bloque para coloreado léxico en parsers compatibles.
Qué debes recordar #
Usa triples comillas invertidas indicando el identificador del lenguaje para habilitar el coloreado sintáctico en documentación técnica.