Texto de programas

Imaginemos que estamos creando un libro sobre el lenguaje de programación Python, y en el archivo markdown escribimos:

Ejemplo de programa Python:

x = 7
y = 3
z = x*y*2
print(z)

lo que se verá así:

Ejemplo de programa Python:

x = 7 y = 3 z = xy2 print(z)

Tenemos un problema. El conjunto de instrucciones del programa de ejemplo se deshace para formar una línea única, y los asteriscos, que representan una multiplicación, se interpretan como letra en cursiva.

Queremos que el texto del programa no sea interpretado, y se muestre tal cual, respetando todos los caracteres, formato y saltos de línea. Lo logramos sangrándolo cuatro espacios:

Ejemplo de programa Python:

    x = 7
    y = 3
    z = x*y*2
    print(z)

Lo que muestra:

Ejemplo de programa Python:

x = 7
y = 3
z = x*y*2
print(z)

Este tipo de bloques sangrados forman lo que se conoce como bloques preformateados. Las marcas HTML y markdown no se interpretan, y se muestran tal cual. El tipo de letra usado suele ser monoespaciada. Los efectos de color suelen establecerse con hojas de estilo css.

Copiar bloque

Los bloques preformateados tienen una característica especial. MdBook hace que, al pasar el ratón por el texto del bloque, en la esquina del recuadro se muestre un icono para copiar el contenido al portapapeles.

Probemos a pasar el ratón sobre lo siguiente:

texto a copiar

Fragmentos de párrafos

Existe un caso especial de texto preformateado, el que se limita a un fragmento de párrafo. Por ejemplo:

Usar *texto entre asteriscos* para mostrar en cursiva

Aquí vemos que respetamos los asteriscos como texto regular y mostramos el fragmento con un tipo de letra especial. esto se logra delimitándolo entre acentos invertidos (backticks):

Usar `*texto entre asteriscos*` para mostrar en cursiva

En el resultado final, se suprime la visualización de los backtics, se respeta el contenido del fragmento, y se muestra con una fuente de letra monosespaciada y resaltada:

¿Que pasa si el contenido del fragmento tiene a su vez caracteres ` backtick que hay que respetar? Usar un doble backtick como delimitador:

``Esto contiene caracteres ` backtick``

¿Como hacer que los baskticks se consideren como texto regular? Precederlos por una barra invertida, que será suprimida del resultado final:

Este párrafo contiene caracteres \` backtick

Lo que muestra el párrafo como texto regular:

Este párrafo contiene caracteres ` backtick