# What changed in sphinx-llm

> 21 changes in sphinx-llm 1 from its official release notes, upgrade guides and advisories: 6 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/pypi/sphinx-llm/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## sphinx-llm 1

### New APIs and options

- Add HTML discovery metadata for llms.txt v2. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Unknown node warnings can now be surfaced or suppressed. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Adds support for a custom override source for llms.txt. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Adds configuration for docref presentation. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Adds an option to exclude documents from llms.txt outputs. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Generates page summaries for llms.txt. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)

### Behavior and default changes

- Generation of llms-full.txt is now opt-in. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Generate nested llms.txt indexes scoped to their location. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Links and images are stripped from llms.txt summaries. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Markdown suffix modes now align with llms.txt v2. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Updates the default model to qwen3.5:2b. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Changes docref summaries to be Sphinx-native. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Uses OpenAI-compatible APIs for docref summaries. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)

### Tooling

- Check llms.txt using the reference parser. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)

### Fixes and other changes

- Command-line overrides are forwarded to Markdown builds. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Generated llms.txt entries are escaped. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- The primary build's tags are forwarded to the Markdown sub-build. (1.1.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.1.0)
- Resolves Markdown links after output selection. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Prevents spawning or orphaning the markdown sub-build when the primary build fails. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Passes the primary build's configuration directory to the markdown sub-build. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)
- Follows toctree order in llms.txt. (1.0.0) — [release notes](https://github.com/NVIDIA/sphinx-llm/releases/tag/v1.0.0)