代理用 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。
  • 當某個頁面需要比一般內容更多額外上下文時,這個面板會很有幫助。

如何使用

  1. 開啟 Airygen SEO -> 設定 -> 代理用 Markdown
  2. 開啟 啟用 Markdown 輸出
  3. 決定是否要讓編輯器提供 代理提示
  4. 決定是否開啟 包含 YAML front matter
  5. 要包含的文章類型 中選擇哪些內容類型應提供 Markdown 匯出。
  6. 開啟 快照 分頁,若你希望現有內容立即重新產生,請點擊 重新建立
  7. 使用 文章類型篩選 與快照表格,檢查目前已產生哪些內容。
  8. 開啟 預覽 分頁,輸入已發佈的 文章 ID,再點擊 預覽 檢查實際 Markdown 輸出。
  9. 如果你啟用了 代理提示,請開啟文章編輯器,在 代理提示 面板中加入頁面專用的 agent 指示。
  10. 使用 檢視 開啟快照,或在支援文章網址後加上 ?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,再決定是否擴大使用。