FAIR

Federated and Independent Repositories

ReturnGIS Markdown View for AI Agents

Plugin Banner

ReturnGIS Markdown View for AI Agents

by Gisela Torres

Download
Description

ReturnGIS Markdown View for AI Agents adds a small button to singular posts and pages so visitors, crawlers, and AI agents can open a clean Markdown version of the content.

The same Markdown output is also available programmatically by appending ?format=markdown to a post or page URL.

The generated Markdown includes YAML frontmatter with useful metadata and converts common HTML elements into Markdown-friendly output.

Features include:

  • Visible “View as Markdown” button on posts and pages
  • ?format=markdown endpoint for agents and automation tools
  • YAML frontmatter with title, author, date, categories, tags, and URL
  • HTML-to-Markdown conversion for headings, lists, links, images, code blocks, blockquotes, and tables
  • Cached output using WordPress transients for faster repeat requests
  • Lightweight front-end integration with no external services required

Typical use cases:

  • AI agents that need a stable Markdown representation of a post
  • internal automation or export workflows that consume article content
  • debugging or reviewing how WordPress content is exposed outside the theme layer
  1. Upload the returngis-markdown-view-for-ai-agents folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress admin.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Open any published post or page.
  4. Click the “View as Markdown” button, or append ?format=markdown to the URL.
Which content types are supported?

The plugin supports singular posts and pages on the front end.

How do agents or automation tools access the Markdown output?

AI agents append ?format=markdown to any post URL. The plugin returns the content as text/markdown with YAML frontmatter metadata.

Does this change my regular theme output?

No. The normal front-end rendering stays the same, except for the added “View as Markdown” button on singular posts and pages.

Does this affect SEO?

No. The button link uses rel="nofollow" and the Markdown response includes a X-Robots-Tag: noindex header.

Is the Markdown cached?

Yes. The plugin caches the generated Markdown for 1 hour using WordPress transients. The cache is cleared automatically when you update a post.

1.0.7

  • updated the Tested up to header to WordPress 7.1

1.0.6

  • addressed WordPress.org review feedback for plugin name, slug, and text domain
  • sanitized button HTML markup returned from the_content filter callback using wp_kses

1.0.5

  • updated the Tested up to header to WordPress 7.0

1.0.4

  • addressed WordPress.org review feedback for contributor metadata
  • escaped the generated Markdown output

1.0.3

  • renamed the plugin to Markdown View for AI Agents
  • aligned the distributed slug with markdown-view-for-ai-agents
  • added a WordPress.org name availability check to the release guidance

1.0.2

  • aligned the distributed plugin slug with markdown-view-for-ai-agents
  • removed WordPress.org Plugin Check warnings from the plugin bootstrap
  • added Plugin Check support and SVG-to-PNG tooling to the dev container workflow

1.0.1

  • Improved WordPress.org readme formatting and public metadata

1.0.0

  • Initial release
  • HTML-to-Markdown converter
  • Button injection on posts and pages
  • ?format=markdown URL handler
  • YAML frontmatter with metadata
  • Transient caching
Back to top