Merge branch '2.x' of https://github.com/craftcms/html-field into 3.x

Author: brandonkelly

composer.json

@@ -20,7 +20,8 @@
   "prefer-stable": true,
   "require": {
     "php": "^8.2",
-    "craftcms/cms": "^5.0.0-beta.1"
+    "craftcms/cms": "^5.0.0-beta.1",
+    "league/html-to-markdown": "^5.1"
   },
   "require-dev": {
     "craftcms/ecs": "dev-main",

composer.lock

@@ -8,6 +8,7 @@
 namespace craft\htmlfield;
 
 use Craft;
+use League\HTMLToMarkdown\HtmlConverter;
 use Twig\Markup;
 
 /**
@@ -58,4 +59,41 @@ public function getParsedContent(): string
     {
         return (string)$this;
     }
+
+    /**
+     * Returns the content as Markdown.
+     *
+     * @param array $config HtmlConverter configuration
+     * @return string
+     * @since 3.2.0
+     */
+    public function getMarkdown(array $config = []): string
+    {
+        $converter = new HtmlConverter([
+            'header_style' => 'atx',
+            'remove_nodes' => 'meta style script',
+            ...$config,
+        ]);
+        return $converter->convert($this->getParsedContent());
+    }
+
+    /**
+     * Returns the content as Markdown.
+     *
+     * @return string
+     * @since 3.2.0
+     */
+    public function getPlainText(): string
+    {
+        $text = $this->getMarkdown([
+            'strip_tags' => true,
+            'strip_placeholder_links' => true,
+            'hard_break' => true,
+        ]);
+
+        // remove heading chars
+        $text = preg_replace('/^#* /m', '', $text);
+
+        return $text;
+    }
 }