# エージェントが読める Markdown

すべてのページは 2 回公開されます。人のための HTML と、エージェントのための元の Markdown です。

> [!NOTE]
> このページは[英語の原文](../../../guides/agents/)の翻訳です。内容が異なる場合は英語版が優先されます。

## Markdown 版

`guide.md` というページは `/guide/index.md` でも配信され、その内容は本文とバイト単位で同一です。Jekyll 4 ではテーマのプラグインが Markdown 版を自動で作ります。

```yaml
plugins: [jekyll-theme-modootoday]
```

クラシックな GitHub Pages ビルドはプラグインを実行できないので、代わりに各ページの隣にスタブを置きます。

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

`twin_of` はスタブファイルからの相対パスです（`include_relative` で読み込みます）。スタブはページと同じフォルダーに置くか、`../` のパスを使ってください。サイトのソースの外や `_` フォルダーは指せません。

```yaml
# guides/install.md の隣のスタブ guides/install.md.txt
twin_of: install.md          # 正しい: スタブからの相対パス
twin_of: guides/install.md   # 誤り: サイトのルートからのパスは "Could not locate the included file" のエラーになります
```

各 HTML ページは `rel="alternate" type="text/markdown"` で Markdown 版にリンクします。

## llms.txt

`/llms.txt` は [llmstxt.org](https://llmstxt.org) に従って、ある言語のすべてのページを一覧にします。`/llms-full.txt` はすべてのページ本文をつなげたものです。どちらも 1 行のスタブから作られます。

```yaml
---
layout: llms
---
```

このサイトで試せます: [llms.txt](../../llms.txt) と [llms-full.txt](../../llms-full.txt)。

## 次へ

[変更履歴](../../reference/changelog/) [ホーム](../../)