Agent-readable Markdown

Markdown twins

A page guide.md is also served at /guide/index.md, byte-identical to its body. On Jekyll 4 the theme plugin creates twins automatically:

plugins: [jekyll-theme-modootoday]

The classic GitHub Pages build cannot run plugins, so add a stub next to each page instead:

# guide.md.txt
---
layout: twin
twin_of: guide.md
permalink: /guide/index.md
---

twin_of is a path relative to the stub file (it is read with include_relative), so keep the stub in the same folder as its page or use ../ paths. It cannot point outside the site source or into _ folders.

# guides/install.md.txt, next to guides/install.md
twin_of: install.md          # correct: relative to the stub
twin_of: guides/install.md   # wrong: a path from the site root fails with "Could not locate the included file"

Each HTML page links its twin with rel="alternate" type="text/markdown".

llms.txt

/llms.txt lists every page of a language, following llmstxt.org. /llms-full.txt concatenates every page body. Both come from one-line stubs:

---
layout: llms
---

Try them on this site: llms.txt and llms-full.txt.