LLM endpoints

Every Bloques site exposes two endpoints that return your content as plain markdown — so AI tools (large language models) can ingest your docs without parsing HTML. Both are active by default on every site, on your <subdomain>.bloques.site URL and any custom domain. No setup required.

/llms.txt — site index

A plain-text index of every page on your site, following the llms.txt convention. Paste this URL into an AI tool to give it the full table of contents in one fetch.

URL pattern

https://<subdomain>.bloques.site/llms.txt

Contents

• An H1 with your site name (from docs.json).
• A blockquote with your site description, when set.
• A ## Docs section listing every page as a markdown link to its .md variant.

Example response

# Acme Docs

> Documentation for the Acme platform.

## Docs

- [Quickstart](https://your-site.bloques.site/quickstart.md)
- [Introduction](https://your-site.bloques.site/introduction.md)
- [Connect GitHub](https://your-site.bloques.site/publishing/connect-github.md)

The response is served as text/plain; charset=utf-8.

Per-page markdown

Every page on your site is also available as markdown. Two equivalent ways to request it:

• Append .md to any page URL.
• Send Accept: text/markdown on the regular page URL — Bloques returns the markdown variant.

URL pattern

https://<subdomain>.bloques.site/<page-slug>.md

Contents

Every .md response starts with a # Title (url) header.

For a page backed by a file in your repository, the body is the raw source with frontmatter stripped. MDX components stay as written — they're not rendered to HTML.

Generated API reference pages have no source file. Their body is a summary built from the OpenAPI spec: the method and path, the operation's description, and its parameters, request body, and responses.

Example response

# Quickstart (/quickstart)

Bloques turns a GitHub repository of MDX files into a documentation site.

## Prerequisites

- A GitHub account.
- A repository with at least one `.mdx` file and a `docs.json` at the root.

<Steps>
  <Step title="Create a site">
    ...
  </Step>
</Steps>

The response is served as text/markdown; charset=utf-8.

Point an AI tool at your site

Most AI tools accept a URL as context. Paste the /llms.txt URL into the tool's context-loading input — the tool follows the links inside to pull the full set of pages. For a single page, paste the .md URL for that page directly.

Next steps