first version

kirby/src/Text/Markdown.php

@@ -0,0 +1,76 @@
+<?php
+
+namespace Kirby\Text;
+
+use Parsedown;
+use ParsedownExtra;
+
+/**
+ * The Markdown class is a wrapper around all sorts of Markdown
+ * parser libraries and is meant to standardize the Markdown parser
+ * API for all Kirby packages.
+ *
+ * It uses Parsedown and ParsedownExtra by default.
+ *
+ * @package   Kirby Text
+ * @author    Bastian Allgeier <bastian@getkirby.com>
+ * @link      http://getkirby.com
+ * @copyright Bastian Allgeier
+ * @license   MIT
+ */
+class Markdown
+{
+
+    /**
+     * Array with all configured options
+     * for the parser
+     *
+     * @var array
+     */
+    protected $options = [];
+
+    /**
+     * Returns default values for all
+     * available parser options
+     *
+     * @return array
+     */
+    public function defaults(): array
+    {
+        return [
+            'extra'  => false,
+            'breaks' => true
+        ];
+    }
+
+    /**
+     * Creates a new Markdown parser
+     * with the given options
+     *
+     * @param array $options
+     */
+    public function __construct(array $options = [])
+    {
+        $this->options = array_merge($this->defaults(), $options);
+    }
+
+    /**
+     * Parses the given text and returns the HTML
+     *
+     * @param  string $text
+     * @return string
+     */
+    public function parse(string $text): string
+    {
+        if ($this->options['extra'] === true) {
+            $parser = new ParsedownExtra;
+        } else {
+            $parser = new Parsedown;
+        }
+
+        $parser->setBreaksEnabled($this->options['breaks']);
+
+        // we need the @ here, because parsedown has some notice issues :(
+        return @$parser->text($text);
+    }
+}