como-usar-fragmentos-de-codigo-en-markdown

Cómo usar fragmentos de código en Markdown

Los fragmentos de código son útiles para insertar porciones de código dentro del texto. Podemos realizar la inserción en línea, o en su propio bloque.

Sintaxis para Código en Línea

Los fragmentos de código en línea son útiles para insertar pequeñas porciones de código dentro del texto. Por ejemplo, cuando mencionas una función o una palabra clave, puedes resaltar el fragmento de código directamente en el texto.

Para incluir un fragmento de código en línea en Markdown, usa una sola comilla inversa (`) antes y después del código.

Por ejemplo, si tenemos el siguiente markdown,

Al hacer `x = 10` asignamos el valor 10 a la variable `x`

Renderizado quedará así,

Por ejemplo, x = 10 asigna el valor 10 a la variable x.

En el renderizado, el fragmento de código en línea x = 10 aparece con un formato monoespaciado, y el estilo definido para los fragmentos de código

Fragmentos de código en Bloque

La sintaxis de código en bloque es adecuada cuando necesitamos incluir bloques más extensos de código, como funciones completas o ejemplos de código largos.

Para añadir un bloque de código, utilizamos tres comillas inversas (```) antes y después del bloque de código.

Además es posible especificar el lenguaje de programación inmediatamente después de las primeras tres comillas para habilitar el resaltado de sintaxis.

```lenguaje

código

```

Por ejemplo, el siguiente fragmento de Markdown,

```python
def saludar(nombre):
    print(f"Hola, {nombre}!")

saludar("Juan")
```

Renderizado será así,

def saludar(nombre):
    print(f"Hola, {nombre}!")

saludar("Juan")

Resaltado de Sintaxis

El resaltado de sintaxis es una característica que mejora la legibilidad del código al aplicar colores y estilos específicos a diferentes elementos del lenguaje de programación (como palabras clave, variables y comentarios).

No es una funcionalidad estándard de Markdown, si no que la proporciona el programa que estéis usando.

En el renderizado, el bloque de código usará el lenguaje indicado para mostrar el resaltado de sintaxis, si la plataforma de visualización soporta resaltado para ese lenguaje.