A WordPress plugin that returns post content in Markdown format when requested with an Accept header set to text/markdown or a ?format=markdown query parameter.

PHP 8.1+

Send an Accept: text/markdown header to any of these URLs:

• Single post: https://example.com/post-slug/ → Returns post content as Markdown
• Single post with comments: https://example.com/post-slug/feed/ → Returns post + all comments
• Main feed: https://example.com/feed/ → Returns latest posts as Markdown

Examples:

# Single post
curl -H "Accept: text/markdown" https://example.com/my-awesome-post/

# Single post with comments
curl -H "Accept: text/markdown" https://example.com/my-awesome-post/feed/

# Main feed
curl -H "Accept: text/markdown" https://example.com/feed/

For browsers and sharing, use the ?format=markdown query parameter:

• Single post: https://example.com/post-slug/?format=markdown
• Single post with comments: https://example.com/post-slug/feed/?format=markdown
• Main feed: https://example.com/feed/?format=markdown

Examples:

# View in browser
https://example.com/my-awesome-post/?format=markdown

# Get post with comments
https://example.com/my-awesome-post/feed/?format=markdown

# Get main feed
https://example.com/feed/?format=markdown

A dedicated Markdown feed is also available at /feed/markdown/:

curl https://example.com/feed/markdown/

The feed includes:

• Feed metadata (site name, description, last updated, feed URL)
• Post title, author, publication date (ISO 8601), and permalink
• Post categories and tags
• Post content converted to Markdown
• Optional excerpt support
• Optional comment support

Example Output:

# My WordPress Site - Markdown Feed

**Description:** Just another WordPress site
**Last Updated:** 2025-10-03T19:45:00+00:00
**Feed URL:** https://example.com/feed/markdown/

---

# Hello World!

**Author:** John Doe
**Published:** 2025-10-03T12:00:00+00:00
**URL:** https://example.com/hello-world/
**Categories:** News, Updates
**Tags:** announcement, wordpress

Welcome to WordPress. This is your first post. Edit or delete it, then start writing!

---

Feed URL structure:

Markdown feeds are accessible via:

• /feed/markdown/ - Dedicated Markdown feed
• /feed/?format=markdown or /feed/ with Accept: text/markdown - Main feed as Markdown
• /post-slug/feed/?format=markdown or /post-slug/feed/ with Accept: text/markdown - Single post with comments

Note that WordPress requires pretty permalinks to be enabled (Settings → Permalinks must be set to anything other than "Plain").

Autodiscovery:

The plugin automatically adds a <atom:link> element to your site's RSS feed, allowing feed readers and LLMs to discover the Markdown version:

<atom:link href="https://example.com/feed/markdown/" rel="alternate" type="text/markdown" />

composer require roots/post-content-to-markdown

1. Download the latest release
2. Place in wp-content/plugins/post-content-to-markdown/
3. Activate via wp-admin or WP-CLI

Note: After activation, you may need to flush rewrite rules by visiting Settings → Permalinks and clicking "Save Changes" if the /feed/markdown/ endpoint doesn't work immediately.

The plugin provides several filters for customization:

Filter the post types that can be served as Markdown for single posts.

add_filter('post_content_to_markdown/post_types', function ($post_types) {
    // Add support for pages and custom post types
    return ['post', 'page', 'product'];
});

Default: ['post']

Filter the post types included in the Markdown feed.

add_filter('post_content_to_markdown/feed_post_types', function ($post_types) {
    return ['post', 'page'];
});

Default: ['post']

Filter the number of posts included in the Markdown feed.

add_filter('post_content_to_markdown/feed_posts_per_page', function ($count) {
    return 20;
});

Default: 10

Enable or disable comments in the Markdown feed.

add_filter('post_content_to_markdown/feed_include_comments', function () {
    return true;
});

Default: false

Enable or disable post excerpts in the Markdown feed.

add_filter('post_content_to_markdown/feed_include_excerpt', function () {
    return true;
});

Default: false

Filter the cache duration for the Markdown feed in seconds.

add_filter('post_content_to_markdown/feed_cache_duration', function ($duration) {
    return 2 * HOUR_IN_SECONDS; // Cache for 2 hours
});

Default: HOUR_IN_SECONDS (1 hour)

Filter the HTML to Markdown converter options.

add_filter('post_content_to_markdown/converter_options', function ($options) {
    return [
        'header_style' => 'setext',           // Use underline style for H1/H2
        'strip_tags' => false,                // Keep HTML tags without markdown equivalents
        'remove_nodes' => 'script style img', // Remove script, style, and img elements
        'hard_break' => false,                // Convert <br> to two spaces + newline
    ];
});

Available options:

• header_style: 'atx' (default) or 'setext'
• strip_tags: Remove HTML tags without Markdown equivalents (default: true)
• remove_nodes: Space-separated list of DOM nodes to remove (default: 'script style')
• hard_break: Convert <br> to newlines (default: true)

Filter the final Markdown output after conversion.

add_filter('post_content_to_markdown/markdown_output', function ($markdown, $original_html) {
    // Add a footer to all Markdown output
    return $markdown . "\n\n---\nConverted from HTML to Markdown";
}, 10, 2);

Parameters:

• $markdown: The converted Markdown text
• $original_html: The original HTML content

The Markdown feed is cached for 1 hour by default to optimize performance. The cache is automatically cleared when:

• A post is published or updated
• A post is deleted
• Comments are added, edited, or deleted (when comments are included in feed)

You can customize the cache duration using the post_content_to_markdown/feed_cache_duration filter.

• Serving Markdown Based on Accept Headers and User Agent Detection
• The text/markdown Media Type