Initial commit

Author: retlehs

.distignore

@@ -0,0 +1,8 @@
+/.git
+/.github
+/.gitignore
+/.distignore
+/composer.lock
+/composer.json
+/scoper.inc.php
+/vendor

.github/workflows/release.yml

@@ -0,0 +1,49 @@
+name: Build Release
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.1'
+          tools: composer
+
+      - name: Install dependencies (with dev for build tools)
+        run: composer install --optimize-autoloader
+
+      - name: Build prefixed vendor
+        run: |
+          vendor/bin/php-scoper add-prefix --config=scoper.inc.php --force
+          cd vendor_prefixed && composer dump-autoload
+
+      - name: Remove dev dependencies after build
+        run: |
+          rm -rf vendor
+          composer install --no-dev --optimize-autoloader
+
+      - name: Create release artifact
+        run: |
+          mkdir -p /tmp/post-content-to-markdown
+          rsync -av --exclude-from='.distignore' . /tmp/post-content-to-markdown/
+          cd /tmp
+          zip -r post-content-to-markdown.zip post-content-to-markdown/
+
+      - name: Upload release asset
+        uses: actions/upload-release-asset@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          upload_url: ${{ github.event.release.upload_url }}
+          asset_path: /tmp/post-content-to-markdown.zip
+          asset_name: post-content-to-markdown.zip
+          asset_content_type: application/zip

.gitignore

@@ -0,0 +1,3 @@
+vendor
+vendor_prefixed
+composer.lock

README.md

@@ -0,0 +1,80 @@
+# Post Content to Markdown
+
+A WordPress plugin that returns post content in Markdown format when requested with an `Accept` header set to `text/markdown`.
+
+## Usage
+
+Visit any single post on your site with the `Accept` header set to `text/markdown` to get the post content directly as Markdown.
+
+**Example:**
+
+```bash
+curl -H "Accept: text/markdown" https://example.com/my-awesome-post
+```
+
+## Installation
+
+### via Composer
+
+```bash
+composer require roots/post-content-to-markdown
+```
+
+### Manual
+
+1. Download the [latest release](https://github.com/roots/post-content-to-markdown/releases)
+2. Place in `wp-content/plugins/post-content-to-markdown/`
+3. Activate via wp-admin or WP-CLI
+
+## Filters
+
+The plugin provides several filters for customization:
+
+### `post_content_to_markdown/post_types`
+
+Filter the post types that can be served as markdown.
+
+```php
+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']`
+
+### `post_content_to_markdown/converter_options`
+
+Filter the HTML to Markdown converter options.
+
+```php
+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`)
+
+### `post_content_to_markdown/markdown_output`
+
+Filter the final markdown output after conversion.
+
+```php
+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

composer.json

@@ -0,0 +1,23 @@
+{
+    "name": "roots/post-content-to-markdown",
+    "type": "wordpress-plugin",
+    "description": "A plugin that converts post content to Markdown when requested with an `text/markdown` Accept header.",
+    "license": "MIT",
+    "homepage": "https://roots.io/sage/",
+    "authors": [
+        {
+            "name": "Ben Word",
+            "email": "[email protected]",
+            "homepage": "https://github.com/retlehs"
+        }
+    ],
+    "scripts": {
+        "build": "php-scoper add-prefix --force"
+    },
+    "require": {
+        "league/html-to-markdown": "^5.1"
+    },
+    "require-dev": {
+        "humbug/php-scoper": "0.18.7"
+    }
+}

post-content-to-markdown.php

@@ -0,0 +1,77 @@
+<?php
+
+/**
+ * Plugin Name: Post Content to Markdown
+ * Description: Exposes post content as Markdown via HTTP `Accept` headers.
+ * Version: 1.0.0
+ * Author: roots.io
+ */
+
+namespace PostContentToMarkdown;
+
+if (! defined('ABSPATH')) {
+    exit;
+}
+
+// Load the appropriate autoloader
+if (file_exists(__DIR__.'/vendor/autoload.php')) {
+    // Composer installation
+    require_once __DIR__.'/vendor/autoload.php';
+} else {
+    // Standalone plugin with prefixed dependencies
+    require_once __DIR__.'/vendor_prefixed/vendor/autoload.php';
+}
+
+add_action('template_redirect', function () {
+    if (! isset($_SERVER['HTTP_ACCEPT']) || ! str_contains($_SERVER['HTTP_ACCEPT'], 'text/markdown')) {
+        return;
+    }
+
+    $post = get_queried_object();
+    if (! $post || ! is_a($post, 'WP_Post')) {
+        return;
+    }
+
+    $allowed_post_types = apply_filters('post_content_to_markdown/post_types', ['post']);
+
+    if (is_single() && in_array($post->post_type, $allowed_post_types, true)) {
+        header('Content-Type: text/markdown');
+        echo '# '.strip_tags($post->post_title)."\n\n".contentToMarkdown($post->post_content);
+        exit;
+    }
+});
+
+/**
+ * Converts an HTML string into Markdown using the league/html-to-markdown library.
+ *
+ * @param  string  $content  The HTML content to convert.
+ * @return string The converted Markdown.
+ */
+function contentToMarkdown($content)
+{
+    if (empty(trim($content))) {
+        return '';
+    }
+
+    $default_options = [
+        'header_style' => 'atx',
+        'strip_tags' => true,  // Remove HTML tags without markdown equivalents
+        'remove_nodes' => 'script style',  // Remove script and style elements
+        'hard_break' => true,  // Convert <br> to newlines
+    ];
+
+    $options = apply_filters('post_content_to_markdown/converter_options', $default_options);
+
+    // Determine which HtmlConverter class to use based on what's available
+    if (class_exists('\League\HTMLToMarkdown\HtmlConverter')) {
+        $converter = new \League\HTMLToMarkdown\HtmlConverter($options);
+    } else {
+        $converter = new \PostContentToMarkdown\Vendor\League\HTMLToMarkdown\HtmlConverter($options);
+    }
+    $markdown = $converter->convert($content);
+
+    // Clean up excessive newlines (more than 2 consecutive)
+    $markdown = preg_replace("/\n{3,}/", "\n\n", $markdown);
+
+    return apply_filters('post_content_to_markdown/markdown_output', $markdown, $content);
+}

scoper.inc.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+use Isolated\Symfony\Component\Finder\Finder;
+
+return [
+    'prefix' => 'PostContentToMarkdown\Vendor',
+    'output-dir' => 'vendor_prefixed',
+    'finders' => [
+        Finder::create()
+            ->files()
+            ->name(['*.php', 'composer.json'])
+            ->in('vendor/league/html-to-markdown'),
+    ],
+];