에이전트용 Markdown

게시된 콘텐츠를 AI 친화적인 마크다운으로 내보내고 스냅샷, 미리보기, 에이전트 프롬프트를 한곳에서 관리하세요.

개요

에이전트용 Markdown는 게시된 콘텐츠의 AI 친화적인 마크다운 버전을 생성하는 기능입니다. AI 크롤러, 에이전트 워크플로, 또는 지식 베이스 내보내기처럼 HTML보다 더 간결한 마크다운 출력이 필요한 팀에 적합합니다.

관리 경로: Airygen SEO -> 설정 -> 에이전트용 Markdown

이 모듈에서는 마크다운 출력 사용 여부, 포함할 게시물 유형, 기존 스냅샷 다시 생성, 게시물 ID 기준 미리보기, 그리고 에디터 안의 에이전트용 프롬프트 입력까지 함께 관리할 수 있습니다.

설정

이 페이지는 설정, 스냅샷, 미리보기로 나뉩니다.

설정 탭

마크다운 출력 활성화는 게시된 콘텐츠의 마크다운 내보내기 기능을 켜거나 끕니다.
에이전트용 프롬프트는 에디터에 패널을 추가해 LLM 에이전트용 설명, 지침, 프롬프트를 입력할 수 있게 합니다.
YAML 프론트 매터 포함은 마크다운 상단에 제목, 작성자, 게시일, 표준 URL, 키프레이즈 같은 메타데이터를 추가합니다.
포함할 게시물 유형은 어떤 게시물 유형을 마크다운으로 내보낼지 결정합니다.

스냅샷 탭

다시 빌드는 기존 마크다운 스냅샷을 백그라운드에서 다시 생성합니다.
게시물 유형 필터는 현재 범위에 포함된 특정 게시물 유형만 스냅샷 목록에서 보이도록 좁혀 줍니다.
스냅샷 표에서는 게시물 ID, 제목, 게시물 유형, 마지막 동기화를 확인할 수 있습니다.
보기는 해당 게시물의 마크다운 버전을 엽니다.
페이지 이동 컨트롤을 사용하면 여러 스냅샷 페이지를 오가며 결과를 검토할 수 있습니다.

미리보기 탭

게시물 ID에는 마크다운 미리보기 또는 내보내기를 확인할 게시된 글의 ID를 입력합니다.
미리보기는 현재 저장된 모듈 설정을 기준으로 마크다운 출력을 생성합니다.
출력 영역에서는 생성된 마크다운을 읽기 전용 상태로 확인할 수 있습니다.

편집기 패널

에이전트용 프롬프트를 활성화하면 각 게시물 편집 화면에 에이전트용 프롬프트 입력 영역이 나타납니다.

이 입력란에는 페이지별 설명, 추가 지침, 또는 LLM 에이전트용 프롬프트를 넣을 수 있습니다.
본문만으로는 충분하지 않은 맥락을 전달해야 하는 페이지에서 특히 유용합니다.

사용 방법

Airygen SEO -> 설정 -> 에이전트용 Markdown를 엽니다.
설정 탭에서 마크다운 출력 활성화를 켭니다.
에디터에서 페이지별 지침을 입력할 계획이 있다면 에이전트용 프롬프트도 함께 활성화합니다.
마크다운 파일 상단에 메타데이터를 포함하려면 YAML 프론트 매터 포함을 켭니다.
포함할 게시물 유형에서 실제로 마크다운 내보내기를 허용할 콘텐츠 유형만 선택합니다.
기존 게시물도 바로 반영하려면 스냅샷 탭으로 이동해 다시 빌드를 실행합니다.
같은 스냅샷 탭에서 게시물 유형 필터를 사용해 범위를 좁히고, 스냅샷 표의 게시물 ID, 제목, 마지막 동기화를 확인합니다.
필요한 항목은 보기로 열어 실제 생성된 마크다운 스냅샷이 기대한 구조인지 검토합니다.
미리보기 탭으로 이동해 게시된 글의 게시물 ID를 입력하고 미리보기를 실행해 현재 설정 기준의 결과를 확인합니다.
에이전트용 프롬프트를 켰다면 실제 게시물 편집 화면을 열어 해당 입력란에 페이지별 설명이나 에이전트 지침을 추가합니다.
마지막으로 스냅샷을 다시 열거나 지원되는 게시물 URL 뒤에 ?format=md를 붙여 공개 마크다운 출력이 예상대로 열리는지 확인합니다.

저장 후에는 다음 항목을 확인하세요.

마크다운 출력이 의도한 게시물 유형에만 노출됩니다.
YAML 프론트 매터 포함을 켠 경우에만 상단 메타데이터가 나타납니다.
다시 빌드 후 스냅샷 목록의 마지막 동기화 시간이 최근 시각으로 갱신됩니다.
의도적으로 추가한 에이전트용 프롬프트 내용만 마크다운 출력에 반영됩니다.

SEO 이점

이 모듈이 직접 순위를 올려 주는 것은 아니지만, 콘텐츠의 기계 친화적인 버전을 더 깔끔하게 제공합니다. 그 결과 AI 대상 워크플로와 마크다운 기반 재사용 흐름을 더 일관되게 유지하고 관리하기 쉬워질 수 있습니다.

활용 사례

AI가 읽기 쉬운 지식 콘텐츠를 운영하는 팀

이전에는 일반 HTML 페이지에 탐색 요소와 레이아웃 요소가 함께 들어 있어, AI 도구가 핵심 내용만 안정적으로 읽거나 재사용하기가 불편했습니다.

이후에는 에이전트용 Markdown를 사용해 더 정돈된 마크다운 버전을 만들고, 스냅샷과 미리보기에서 결과를 먼저 확인한 뒤 지식 내보내기 흐름에 연결할 수 있습니다.

페이지별 AI 지침을 따로 관리해야 하는 에이전시

이전에는 일부 랜딩 페이지나 문서에만 필요한 AI용 설명을 넣을 자리가 없어, 본문을 불필요하게 바꾸거나 별도 문서로 관리해야 했습니다.

이후에는 에이전트용 프롬프트 패널에 페이지별 지침을 직접 저장해, 방문자에게 보이는 글은 그대로 유지하면서 에이전트용 맥락만 별도로 정리할 수 있습니다.

자주 묻는 질문

이 기능이 방문자가 보는 일반 HTML 페이지를 바꾸나요?

아니요. 이 기능은 지원되는 워크플로를 위한 마크다운 출력을 추가할 뿐이며, 일반 페이지 보기를 대체하지는 않습니다.

YAML 프론트 매터 포함을 켜면 무엇이 추가되나요?

제목, 작성자, 게시일, 표준 URL, 키프레이즈 같은 상단 메타데이터가 마크다운 파일 앞부분에 추가됩니다.

전체 사이트에 적용하기 전에 게시물 하나만 먼저 확인할 수 있나요?

예. 미리보기 탭에서 게시된 글의 게시물 ID를 입력하고 생성된 마크다운을 먼저 검토한 뒤 범위를 넓히면 됩니다.