# Contenu pour les LLM

Les modèles de langage lisent plus facilement le Markdown que le HTML. Cecil leur fournit deux [formats de sortie](../configuration/8-output.fr.md#formats-par-defaut) :

- `llms` : un fichier [`llms.txt`](https://llmstxt.org), index du site ;
- `markdown` : une version Markdown de chaque page.

Les deux sont désactivés par défaut.

## llms.txt

Depuis la version ++8.114.0++, le format `llms` génère la page d’accueil sous la forme d’un fichier `llms.txt` à la racine du site. Il contient :

- le titre et la description du site ;
- les liens du menu principal (les URL externes sont ignorées) ;
- les sections de premier niveau et leurs pages (les sous-sections sont imbriquées), avec leur titre et leur description.

Pour l’activer, ajoutez le format à la page d’accueil :

```yaml
output:
  pagetypeformats:
    homepage:
      llms: true
```

Avec le template [metatags](../configuration/1-site.fr.md#metatags), la page d’accueil HTML référence le fichier avec une balise `<link rel="describedby" type="text/markdown">`.

### Exclure du contenu

Pour exclure une page ou une section (et ses pages) de `llms.txt`, définissez `llms: false` dans son front matter :

```yaml
---
title: "Mentions légales"
llms: false
---
```

Les sections non publiées et [exclues](../content/2-front-matter.fr.md#excluded) ne sont pas listées.

## Pages Markdown

Le format `markdown` génère une page sous la forme d’un fichier Markdown, à côté de sa version HTML (ex. : `blog/post-1.md` pour `blog/post-1/index.html`). Le fichier contient le titre et le corps de la page ; une section liste ses pages.

Pour générer toutes les pages et sections en Markdown :

```yaml
output:
  pagetypeformats:
    page:
      markdown: true
    section:
      markdown: true
```

Ou pour une seule page, avec la variable [`output`](../content/2-front-matter.fr.md#output) :

```yaml
---
output: [html, markdown]
---
```

Avec le template [metatags](../configuration/1-site.fr.md#metatags), la page HTML référence sa version Markdown avec une balise `<link rel="alternate" type="text/markdown">`. Les liens de `llms.txt` pointent vers la version Markdown des pages lorsqu’elle existe.

## Templates

Pour personnaliser ces sorties, surchargez les templates par défaut dans votre répertoire `layouts` (voir les [règles de recherche](../templates/1-lookup-rules.fr.md)) :

- `home.llms.twig` : le fichier `llms.txt` ;
- `page.markdown.twig`, `list.markdown.twig` et `home.markdown.twig` : les pages Markdown.