ReturnGIS Markdown View for AI Agents
🤖 Turn WordPress posts and pages into clean Markdown for AI agents 📄
by Gisela Torres · github.com/0gis0/markdown-view-for-agents · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/0gis0/markdown-view-for-agents/archive/refs/heads/main.zip
Turn WordPress posts and pages into clean Markdown for AI agents, automation tools, and humans. Add ?format=markdown to any singular post or page URL and the plugin returns a Markdown response with YAML frontmatter and Markdown-friendly content.
[!TIP] Want the fastest install path? Download the latest plugin package here: returngis-markdown-view-for-ai-agents.zip
This README is the GitHub landing page for releases, development, and creator links. The WordPress.org-specific plugin description stays in readme.txt.
Why use it?
- Exposes published posts and pages as
text/markdown - Adds a visible "View as Markdown" button on the front end
- Includes YAML frontmatter with title, author, date, taxonomy terms, and canonical URL
- Converts headings, lists, links, images, blockquotes, code blocks, and tables into Markdown-friendly output
- Caches generated output with WordPress transients for faster repeated requests
- Keeps your normal theme rendering unchanged outside the optional Markdown endpoint
Install from GitHub release
This is the recommended path if you just want to use the plugin in WordPress.
- Download the latest release asset: returngis-markdown-view-for-ai-agents.zip
- In WordPress admin, go to Plugins > Add New Plugin > Upload Plugin.
- Upload the ZIP file and activate the plugin.
- Open any published post or page and click "View as Markdown", or append
?format=markdownto the URL.
Install from source
This path is better if you want to inspect, modify, or contribute to the project.
cd wp-content/plugins/
git clone https://github.com/0GiS0/markdown-view-for-agents.git
cd markdown-view-for-agents
composer install
Then activate the plugin from the WordPress admin panel.
If you want the packaged ZIP locally, run:
chmod +x package-plugin.sh
./package-plugin.sh
That creates dist/returngis-markdown-view-for-ai-agents.zip.
Usage
In the browser
Visit any published post or page and use the "View as Markdown" button injected by the plugin.
For agents and automation
Append ?format=markdown to any supported URL:
https://yourblog.com/my-awesome-post/?format=markdown
The response is served as text/markdown; charset=utf-8 and includes YAML frontmatter.
---
title: "My Awesome Post"
author: "Gisela Torres"
date: "2026-03-08"
categories: ["Tech", "AI"]
tags: ["wordpress", "markdown"]
url: "https://yourblog.com/my-awesome-post/"
---
# My Awesome Post
Article content in clean Markdown...
Supported output
| HTML element | Markdown output |
|---|---|
<h1> to <h6> |
# to ###### |
<p> |
Paragraphs with blank-line separation |
<strong>, <b> |
**bold** |
<em>, <i> |
*italic* |
<a href="..."> |
[text](url) |
<img> |
 |
<ul>, <ol> |
- item and 1. item |
<pre><code> |
Fenced code block |
<blockquote> |
> quote |
<table> |
Markdown table |
<hr> |
--- |
<code> |
Inline code |
Requirements
- WordPress 5.0 or newer
- PHP 7.4 or newer
Project links
Follow the creator
Built by Gisela Torres. If you want more developer content around AI, GitHub, and tooling, you can follow these channels:
License
GPL v2 or later. See LICENSE.