llms.txt e llms-full.txt
O Seed pode gerar arquivos em markdown com o conteúdo do seu site, no formato pensado para consumo por LLMs (padrão llmstxt.org).
Não confunda com Criando páginas com IA — aquela página é sobre usar IA para escrever documentação em Seed. Esta aqui é sobre gerar arquivos para uma IA ler o seu site já publicado.
Configuração
A chave llms no seed.yaml controla a geração. Ela aceita um valor simples (modo) ou um dicionário com opções adicionais.
Forma simples
```yaml llms: both ```
Modos disponíveis:
| Valor | Efeito |
|---|---|
index | Gera dist/llms.txt — um índice com título, URL e descrição de cada página. |
full | Gera dist/llms-full.txt — o markdown completo de todas as páginas, concatenado. |
both | Gera os dois arquivos. |
true | Equivale a both. |
| (ausente ou outro valor) | Nada é gerado. |
Este site usa llms: both — é assim que llms.txt e llms-full.txt foram gerados para esta documentação.
Forma dicionário
Para mais controle sobre a geração, use um dicionário em vez do valor simples:
```yaml llms: mode: both nav: _sidebar.seed orphans: skip skip: [meu-componente-visual] ```
| Chave | Comportamento |
|---|---|
mode | Mesmos valores da forma simples (index, full, both, true). |
nav | Nome de um arquivo .seed de navegação (ex.: _sidebar.seed). Define a ordem das páginas no llms.txt e, no llms-full.txt, também agrupa o conteúdo sob os títulos de seção da navegação. |
orphans | skip (padrão) ou include. Controla o que fazer com páginas que existem mas não aparecem no arquivo de nav. |
skip | Lista de nomes de componentes a descartar na extração. Estende a lista padrão — não a substitui. Aceita lista YAML ou string separada por vírgula. |
O que é extraído
O Seed percorre a árvore de cada página e converte para markdown os componentes de conteúdo: @h1–@h6, @p/@lead, @ul/@ol/@li, @pre, @blockquote, @markdown, @image, e os inline @code/@strong/@em/@a. Componentes puramente visuais que só embrulham outros (cards, heróis, layouts) são atravessados de forma transparente — o conteúdo de dentro deles é extraído normalmente, só a embalagem é descartada.
Alguns componentes são sempre descartados na extração, mesmo sem configurar skip:
``` pagination, breadcrumb, nav, footer, docs-footer, docs-nav, share, toc, prev-next ```
O @table também não é extraído: tabelas raramente carregam semântica em documentação Seed, então o componente é descartado inteiro. Se o conteúdo de uma tabela precisa aparecer no llms.txt, repita a informação em texto corrido ou em lista.
Excluindo páginas
Front matter que faz uma página ser pulada na geração:
| Front matter | Efeito |
|---|---|
draft: true | Página não é construída — nem entra no build, nem no llms.txt. |
noindex: true | Página é construída mas excluída do llms.txt. |
llms: false | Página é construída normalmente, mas excluída apenas do llms.txt/llms-full.txt. |
No dev server
Durante o seed dev, as rotas /llms.txt e /llms-full.txt respondem sempre, independente da configuração no seed.yaml — e são regeradas a cada request a partir do código-fonte vivo. Isso facilita conferir o resultado enquanto você escreve o conteúdo, sem precisar rodar um build.
Feito com ❤️ e Seed