代理用 Markdown
為已發佈內容產生適合 AI 使用的 Markdown 版本,並在同一個模組中管理快照、預覽與 Agent 提示。
概覽
代理用 Markdown 會為已發佈內容建立適合 AI 使用的 Markdown 版本。它特別適合希望提供更乾淨 Markdown 輸出給 AI crawler、agent 工作流程或知識庫匯出的團隊。
後台路徑:Airygen SEO -> 設定 -> 代理用 Markdown
這個模組可讓你控制 Markdown 輸出、選擇納入的文章類型、重建快照、用文章 ID 預覽匯出內容,並在編輯器中加入針對 agent 的頁面提示。
設定
此頁面分為 設定、快照 與 預覽。
設定 分頁
- 啟用 Markdown 輸出 用來開啟或關閉 Markdown 匯出。
- 代理提示 會啟用編輯器面板,讓你為 LLM agent 加入描述、指示或提示。
- 包含 YAML front matter 會在 Markdown 頂部加入標題、作者、發佈日期、canonical URL 與 keyphrase 等中繼資料。
- 要包含的文章類型 用來決定哪些文章類型要匯出為 Markdown。
快照 分頁
- 重新建立 會在背景重新產生 Markdown 快照。
- 文章類型篩選 可把快照表格縮小到所選且在範圍內的文章類型。
- 快照表格會顯示 文章 ID、標題、文章類型 與 上次同步。
- 檢視 可開啟該文章的 Markdown 版本。
- 分頁控制可讓你切換不同快照頁面。
預覽 分頁
- 文章 ID 可讓你載入特定已發佈文章的 Markdown 預覽。
- 預覽 會依照目前模組設定發出預覽請求。
- 輸出內容 會以唯讀文字區塊顯示產生出的 Markdown。
編輯器面板
當 代理提示 啟用後,編輯器會為每篇文章顯示 代理提示 文字區。
- 你可以用它加入頁面層級的描述、指示或提示給 LLM agent。
- 當某個頁面需要比一般內容更多額外上下文時,這個面板會很有幫助。
如何使用
- 開啟 Airygen SEO -> 設定 -> 代理用 Markdown。
- 開啟 啟用 Markdown 輸出。
- 決定是否要讓編輯器提供 代理提示。
- 決定是否開啟 包含 YAML front matter。
- 在 要包含的文章類型 中選擇哪些內容類型應提供 Markdown 匯出。
- 開啟 快照 分頁,若你希望現有內容立即重新產生,請點擊 重新建立。
- 使用 文章類型篩選 與快照表格,檢查目前已產生哪些內容。
- 開啟 預覽 分頁,輸入已發佈的 文章 ID,再點擊 預覽 檢查實際 Markdown 輸出。
- 如果你啟用了 代理提示,請開啟文章編輯器,在 代理提示 面板中加入頁面專用的 agent 指示。
- 使用 檢視 開啟快照,或在支援文章網址後加上 ?format=md,確認公開的 Markdown 輸出。
儲存後請確認以下項目:
- 只有你想公開的文章類型才啟用了 Markdown 輸出。
- 只有在開啟 包含 YAML front matter 時才會出現 front matter。
- 重新產生快照後,快照 會顯示最近同步時間。
- Markdown 輸出只包含你刻意加入的 agent prompt 內容。
SEO 效益
這個模組不會直接改變排名,但能為你的內容提供更乾淨、機器可讀的版本,讓 AI 導向與 Markdown 導向的工作流程更一致,也更容易維護。
使用情境
發佈 AI 可讀知識內容的團隊
調整前:公司希望文件更容易被 AI 工具使用,但一般 HTML 輸出夾帶了許多不利於 Markdown 工作流程的頁面結構。
調整後:代理用 Markdown 提供更乾淨的 Markdown 版本,讓內容更容易預覽、匯出與再利用。
需要加入頁面層級 AI 指示的代理商
調整前:某些頁面需要額外上下文給 AI agent,但目前沒有結構化位置可存放這些說明。
調整後:代理提示 編輯器面板可讓代理商加入頁面專用指示,而不必改寫使用者可見的文章內容。
常見問題
這會改變訪客看到的正常 HTML 頁面嗎?
不會。它會額外提供 Markdown 輸出給特定工作流程使用,但不會取代一般頁面檢視。
包含 YAML front matter 會加入什麼?
它會在檔案頂部加入標題、作者、發佈日期、canonical URL 與 keyphrase 等中繼資料。
我可以先預覽單篇文章,再決定是否整體啟用嗎?
可以。請使用 預覽 分頁,輸入已發佈的 文章 ID,先檢查產生出的 Markdown,再決定是否擴大使用。