Markdown for Agents

Generate AI-friendly markdown versions of published content and manage snapshots, previews, and agent prompts from one module.

Overview

Markdown for Agents creates AI-friendly markdown versions of published content. It is designed for teams that want cleaner markdown output for AI crawlers, agent workflows, or knowledge exports.

Admin path: Airygen SEO -> Settings -> Markdown for Agents

The module lets you control markdown output, choose which post types are included, rebuild snapshots, preview exports by post ID, and add post-level prompts for agents in the editor.

Settings

The page is divided into Settings, Snapshots, and Preview.

Settings tab

  • Enable Markdown output turns markdown export on or off.
  • Prompts for Agents enables an editor panel where you can add descriptions, instructions, or prompts for LLM agents.
  • Include YAML front matter adds metadata such as title, author, publish date, canonical URL, and keyphrase at the top of the markdown.
  • Post types to include decides which post types are exported to markdown.

Snapshots tab

  • Rebuild regenerates markdown snapshots in the background.
  • Post type filter narrows the snapshot table to the selected in-scope post type.
  • The snapshot table shows Post ID, Title, Post type, and Last synced.
  • View opens the markdown version of that post.
  • Pagination controls let you move between snapshot pages.

Preview tab

  • Post ID lets you load a markdown preview for a specific published post.
  • Preview runs the preview request using the current module settings.
  • Output shows the generated markdown in a read-only textarea.

Editor Panel

When Prompts for Agents is enabled, the editor shows a Prompts for Agents textarea for each post.

  • Use it to add page-level descriptions, instructions, or prompts for LLM agents.
  • The panel is helpful when a page needs extra context beyond the normal content itself.

How to Use

  1. Open Airygen SEO -> Settings -> Markdown for Agents.
  2. Turn on Enable Markdown output.
  3. Decide whether Prompts for Agents should be available in the editor.
  4. Decide whether to turn on Include YAML front matter.
  5. In Post types to include, choose which content types should have markdown exports.
  6. Open the Snapshots tab and click Rebuild if you want existing content regenerated right away.
  7. Use Post type filter and the snapshot table to review what has already been generated.
  8. Open the Preview tab, enter a published Post ID, and click Preview to inspect the exact markdown output.
  9. If you enabled Prompts for Agents, open a post in the editor and add any page-specific agent instructions in the Prompts for Agents panel.
  10. Open a snapshot with View or append ?format=md to a supported post URL to confirm the public markdown output.

Check these items after saving:

  • Markdown output is enabled only for the post types you want to expose.
  • Front matter appears only when Include YAML front matter is turned on.
  • Snapshots show recent sync times after a rebuild.
  • The markdown output includes any agent prompt content you intentionally added.

SEO Benefits

This module does not directly change rankings, but it gives you a cleaner machine-readable version of your content. That can make AI-facing and markdown-based workflows more consistent and easier to maintain.

User Cases

Teams publishing AI-readable knowledge content

Before: A company wants its documentation to be easier for AI tools to consume, but the normal HTML output includes extra page structure that is not ideal for markdown workflows.

After: Markdown for Agents provides a cleaner markdown version that is easier to preview, export, and reuse.

Agencies adding page-level instructions for AI use

Before: Some pages need extra context for AI agents, but there is no structured place to store that guidance.

After: The Prompts for Agents editor panel lets the agency add page-specific instructions without rewriting the visible article.

FAQ

Does this change the normal HTML page visitors see?

No. It adds markdown output for supported workflows, but it does not replace the normal page view.

What does Include YAML front matter add?

It adds top-of-file metadata such as title, author, publish date, canonical URL, and keyphrase information.

Can I preview one post before enabling this for everything?

Yes. Use the Preview tab, enter a published Post ID, and inspect the generated markdown before you expand the workflow.