# 에이전트가 읽는 Markdown

모든 페이지는 두 번 게시됩니다. 사람을 위한 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`는 모든 페이지 본문을 이어 붙입니다. 둘 다 한 줄짜리 스텁으로 만듭니다.

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

이 사이트에서 확인해 보세요: [llms.txt](../../llms.txt), [llms-full.txt](../../llms-full.txt).

## 다음

[변경 기록](../../reference/changelog/) [홈](../../)