Incluir ficheros

mdBook tiene una funcionalidad especial, incluir el texto de otro fichero fuente en mitad del contenido de nuestro fichero markdown.

Supongamos que abrimos un Terminal de comandos y ejecutamos:

$ date

En Linux/Mac, esto muestra la fecha y hora:

viernes, 10 de abril de 2026, 15:07:57 CEST

Podemos personalizar la presentación:

$ date "+%d de %B de %Y" 
                   
10 de abril de 2026

O incluso enviar este texto a un fichero (sobreescribiéndolo):

$ date "+%d de %B de %Y" > src/docs/fecha.txt

Con lo que, si ponemos este comando en el script de generación del libro, antes del comando mdBook, tendremos un fichero añadido con la fecha de actualización del libro.

Nota:

---

En Windows, el comando es:

date /t

¿Como beneficiarnos de todo esto? Supongamos que nuestra página principal es:

© 2025 - Mi taller de libros
Fecha de actualización: {{#include fecha.txt}} 

La expresión entre dobles llaves:

{{#include fecha.txt}} 

será sustituida por el contenido del archivo indicado.

Esta posibilidad de incluir el texto de otro fichero tiene muchas posibilidades. Supongamos que estamos escribiendo un manual técnico con ejemplos de programación. Podemos tener dichos ejemplos como archivos en una carpeta aparte, donde los probamos ejecutándolos para ver si producen el efecto deseado. En lugar de copiar el texto de los ejemplos al libro, Los incluimos en el texto:

Veamos el ejemplo 1.1:

```py
{{#include ejemplo11.py}}
```

en lugar de:

Veamos el ejemplo 1.1:

```py
instrucciones del programa
```

Inclusión parcial

Veamos otra posibilidad. Creamos un archivo iconos.txt:

<i class="fa-solid fa-triangle-exclamation"></i>
<i class="fa-solid fa-circle-exclamation"></i>
<i class="fa-solid fa-circle-info"></i>
<i class="fa-regular fa-circle-xmark"></i>
<i class="fa-regular fa-lightbulb"></i>
<i class="fa-regular fa-circle-check"></i>
<i class="fa-solid fa-circle-radiation"></i>

Y para incluir un icono escribimos algo así como:

{{#include iconos.txt:3}} Información importante.

Descripción...

Lo que muestra:

Información importante.

Descripción…

Hemos especificado un nombre de fichero a incluir, seguido de un número de línea, la número 3. Solo se incluirá esa línea:

{{#include iconos.txt:3}}

Podemos incluir ficheros de forma parcial:

• {{#include archivo.txt:2}} - incluir solo línea 2
• {{#include archivo.txt::10}} - desde el principio hasta la línea 10
• {{#include archivo.txt:2:}} - desde la línea 2 hasta el final
• {{#include archivo.txt:2:10}} - desde la línea 2 a la 10