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

Installation

Upload the returngis-markdown-view-for-ai-agents folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress admin.
Activate the plugin through the ‘Plugins’ screen in WordPress.
Open any published post or page.
Click the “View as Markdown” button, or append ?format=markdown to the URL.

FAQ

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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“ReturnGIS Markdown View for AI Agents” is open source software. The following people have contributed to this plugin.

Gisela Torres

Translate “ReturnGIS Markdown View for AI Agents” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

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

Description

Installation

FAQ

Which content types are supported?

How do agents or automation tools access the Markdown output?

Does this change my regular theme output?

Does this affect SEO?

Is the Markdown cached?