Skip to content

ajaykj/serve-markdown

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Serve Markdown

A WordPress plugin that serves clean Markdown versions of your content to AI agents and crawlers.

WordPress 6.5+ PHP 8.1+ License: GPL-3.0

Download from WordPress.org

Overview

AI agents from OpenAI, Anthropic, Google, Perplexity, and others are crawling the web constantly. They read your content not to index it for a search results page, but to understand it — so they can answer questions, summarize topics, and generate responses. These AI consumers don't care about your CSS or JavaScript. What they want is your content: clean, structured, and easy to parse.

Serve Markdown adds three access methods to your WordPress site so AI crawlers get exactly that. Every Markdown response includes YAML frontmatter with structured metadata — title, author, date, categories, tags, featured image — followed by your post content converted from WordPress HTML to clean Markdown. Zero configuration required: install, activate, and it works.

Features

  • Content Negotiation — Responds with Markdown when a request sends Accept: text/markdown
  • .md URLs — Append .md to any post or page URL to get the Markdown version
  • Auto-discovery — Adds <link rel="alternate" type="text/markdown"> to every page head
  • Frontmatter — YAML metadata block with configurable fields on every response
  • Crawler Log — Identifies and logs AI bot requests with per-bot dashboard
  • Admin Controls — Toggle features, choose post types, exclude categories/tags, map custom fields

Requirements

  • WordPress 6.5+
  • PHP 8.1+

Installation

  1. Upload the serve-markdown folder to wp-content/plugins/
  2. Activate the plugin in Plugins > Installed Plugins
  3. Visit Settings > Serve Markdown to review defaults
  4. Test by appending .md to any published post URL

Changelog

1.0

Initial release.

License

GPL-3.0-or-later — see LICENSE for the full text.

About

A WordPress plugin that serves clean Markdown versions of your content to AI agents and crawlers.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors