代理用 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,再决定是否扩大使用。