mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-28 08:49:38 +02:00
67 lines
2 KiB
Text
67 lines
2 KiB
Text
---
|
|
title: Markdown Access
|
|
description: Fetch KTX docs as llms.txt, llms-full.txt, or per-page Markdown.
|
|
---
|
|
|
|
KTX docs are available as plain Markdown so assistants do not need to parse the rendered HTML site.
|
|
|
|
## Index
|
|
|
|
Fetch the curated index:
|
|
|
|
```text
|
|
https://ktx.dev/llms.txt
|
|
```
|
|
|
|
Use this file to discover high-value pages, task-specific entry points, and Markdown URLs.
|
|
|
|
## Full corpus
|
|
|
|
Fetch the complete docs corpus:
|
|
|
|
```text
|
|
https://ktx.dev/llms-full.txt
|
|
```
|
|
|
|
Use this when an assistant needs broad context across setup, concepts, CLI reference, integrations, and troubleshooting. Prefer the smaller per-page Markdown route for narrow tasks.
|
|
|
|
## Per-page Markdown
|
|
|
|
Every docs page has a Markdown route:
|
|
|
|
```text
|
|
https://ktx.dev/docs/getting-started/quickstart.md
|
|
https://ktx.dev/docs/cli-reference/ktx-agent.md
|
|
https://ktx.dev/docs/guides/serving-agents.md
|
|
```
|
|
|
|
Requests that ask for Markdown can also use the normal docs URL with `Accept: text/markdown`:
|
|
|
|
```bash
|
|
curl -H "Accept: text/markdown" https://ktx.dev/docs/getting-started/quickstart
|
|
```
|
|
|
|
## Recommended retrieval order
|
|
|
|
1. Fetch `/llms.txt`.
|
|
2. Select one or two relevant page Markdown URLs.
|
|
3. Fetch `/llms-full.txt` only when page-level docs are not enough.
|
|
|
|
## Output contract
|
|
|
|
Markdown responses are designed for agent consumption:
|
|
|
|
- Frontmatter is removed.
|
|
- Each page includes a title, description, canonical URL, and Markdown URL.
|
|
- Code blocks stay as code blocks.
|
|
- Tables stay as Markdown tables.
|
|
- Missing docs pages return a plain-text `404` instead of silently falling back to HTML.
|
|
|
|
## Common mistakes
|
|
|
|
| Mistake | Better path |
|
|
|---------|-------------|
|
|
| Scraping the HTML page for a docs answer | Fetch the `.md` route instead |
|
|
| Loading `/llms-full.txt` for a single CLI flag lookup | Fetch the relevant CLI reference page |
|
|
| Treating `/llms.txt` as complete documentation | Use it as an index, then fetch linked pages |
|
|
| Assuming docs Markdown configures the product MCP server | Read [Docs vs Product MCP](/docs/ai-resources/mcp-boundaries) first |
|