From 02c6094ccfe074568e850293c769ce6ddd797fc3 Mon Sep 17 00:00:00 2001
From: Ben Thomson <git@alfreido.com>
Date: Tue, 22 Nov 2022 16:23:43 +0800
Subject: [PATCH 1/6] Convert Markdown parser to CommonMark

Drops the requirement for the Parsedown library.
---
 composer.json                                 |   1 -
 src/Parse/Markdown.php                        | 408 +++++++++++++++---
 .../Markdown/CommonMarkCoreExtension.php      | 174 ++++++++
 src/Parse/ParseServiceProvider.php            |   9 +-
 src/Parse/Parsedown/Parsedown.php             |  13 -
 src/Support/aliases.php                       |   1 -
 6 files changed, 520 insertions(+), 86 deletions(-)
 create mode 100644 src/Parse/Markdown/CommonMarkCoreExtension.php
 delete mode 100644 src/Parse/Parsedown/Parsedown.php

diff --git a/composer.json b/composer.json
index 6d7597aa2..2d30d9adf 100644
--- a/composer.json
+++ b/composer.json
@@ -38,7 +38,6 @@
         "assetic/framework": "~3.0",
         "doctrine/dbal": "^2.6",
         "enshrined/svg-sanitize": "^0.15",
-        "erusev/parsedown-extra": "~0.7",
         "laravel/framework": "^9.1",
         "laravel/tinker": "^2.7",
         "league/csv": "~9.1",
diff --git a/src/Parse/Markdown.php b/src/Parse/Markdown.php
index 5146257d1..8fd1c26a5 100644
--- a/src/Parse/Markdown.php
+++ b/src/Parse/Markdown.php
@@ -1,135 +1,405 @@
 <?php namespace Winter\Storm\Parse;
 
+use League\CommonMark\Environment\Environment;
+use League\CommonMark\Extension\Attributes\AttributesExtension;
+use League\CommonMark\Extension\Autolink\AutolinkExtension;
+use League\CommonMark\Extension\DisallowedRawHtml\DisallowedRawHtmlExtension;
+use League\CommonMark\Extension\Footnote\FootnoteExtension;
+use League\CommonMark\Extension\FrontMatter\Data\SymfonyYamlFrontMatterParser;
+use League\CommonMark\Extension\FrontMatter\FrontMatterExtension;
+use League\CommonMark\Extension\FrontMatter\FrontMatterParser;
+use League\CommonMark\Extension\HeadingPermalink\HeadingPermalinkExtension;
+use League\CommonMark\Extension\InlinesOnly\InlinesOnlyExtension;
+use League\CommonMark\Extension\Strikethrough\StrikethroughExtension;
+use League\CommonMark\Extension\Table\TableExtension;
+use League\CommonMark\Extension\TableOfContents\TableOfContentsExtension;
+use League\CommonMark\Extension\TaskList\TaskListExtension;
+use League\CommonMark\Parser\MarkdownParser;
+use League\CommonMark\Parser\MarkdownParserInterface;
+use League\CommonMark\Renderer\DocumentRendererInterface;
+use League\CommonMark\Renderer\HtmlRenderer;
+use Winter\Storm\Parse\Markdown\CommonMarkCoreExtension;
 use Winter\Storm\Support\Facades\Event;
-use Winter\Storm\Parse\Parsedown\Parsedown;
 
 /**
- * Markdown helper class.
+ * Markdown parser.
  *
- * Calling Markdown::parse($text) returns the HTML corresponding
- * to the Markdown input in $text.
+ * This parser allows the parsing and interpretation of Markdown content into raw HTML, as well
+ * as extracting metadata from the Markdown content as necessary.
  *
- * WinterCMS uses ParsedownExtra as its Markdown parser,
- * but fires markdown.beforeParse and markdown.parse events
- * allowing hooks into the default parsing,
+ * This utility has been significantly rewritten to take advantage of the CommonMark library by
+ * The PHP League, and more closely adheres to the CommonMark specification, with GitHub-flavored
+ * Markdown support.
  *
- * The markdown.beforeParse event passes a MarkdownData
- * instance, containing a public $text variable. Event
- * listeners can modify $text, for example to filter out
- * or protect snippets from being interpreted by ParseDown.
- *
- * Similarly, markdown.parse is fired after ParseDown has
- * interpreted the (possibly modified) input. This event
- * passes an array [$text, $data], where $text is the
- * original unmodified Markdown input, and $data is the HTML
- * code generated by ParseDown.
- *
- * @author Alexey Bobkov, Samuel Georges
+ * @author Alexey Bobkov, Samuel Georges (Original implementation based on Parsedown)
+ * @author Ben Thomson <git@alfreido.com> (Rewritten implementation using CommonMark)
  **/
 class Markdown
 {
     use \Winter\Storm\Support\Traits\Emitter;
 
     /**
-     * @var string Parsedown class
+     * Enables the parsing of attributes for block-level and inline content.
      */
-    protected $parserClass = \Winter\Storm\Parse\Parsedown\Parsedown::class;
+    public bool $attributes = false;
 
     /**
-     * Gets an instance of the parser.
-     *
-     * We return a new instance each time to prevent contamination of clean instances.
-     *
-     * @return Parsedown
+     * Enables autolinking of URLs and email addresses in Markdown content.
+     */
+    public bool $autolinking = true;
+
+    /**
+     * Enables the parsing and generation of footnotes.
+     */
+    public bool $footnotes = false;
+
+    /**
+     * Enables the parsing of front matter (metadata).
+     */
+    public bool $frontMatter = false;
+
+    /**
+     * Enables the generation of permalinks for each heading.
+     */
+    public bool $headingPermalinks = false;
+
+    /**
+     * Enables inline-only formatting. This is used for rendering a single line of Markdown.
+     */
+    public bool $inlineOnly = false;
+
+    /**
+     * Enables safe mode - disables certain HTML tags.
+     */
+    public bool $safeMode = false;
+
+    /**
+     * Enables the parsing and generation of task lists.
+     */
+    public bool $taskLists = false;
+
+    /**
+     * Enables the generation of tables.
+     */
+    public bool $tables = true;
+
+    /**
+     * Enables the generation of a table of contents.
+     */
+    public bool $tableOfContents = false;
+
+    /**
+     * Custom configuration for the CommonMark environment.
+     */
+    public array $config = [];
+
+    /**
+     * Extracted front matter (metadata) from the Markdown content.
+     */
+    protected ?array $frontMatterData = null;
+
+    /**
+     * Extracted table of contents from the Markdown content.
+     */
+    protected ?array $tableOfContentData = null;
+
+    /**
+     * The Markdown parser class to use.
      */
-    protected function getParser()
+    protected ?string $parserClass = null;
+
+    /**
+     * The HTML renderer class to use.
+     */
+    protected ?string $rendererClass = null;
+
+    /**
+     * Constructor.
+     */
+    final public function __construct()
     {
-        return new $this->parserClass;
     }
 
     /**
-     * Sets the Markdown parser.
-     *
-     * @param string|object $parserClass
-     * @return void
+     * Parse Markdown content and render as HTML.
      */
-    public function setParser(string|object $parserClass)
+    public function parse(string $markdown): string
     {
-        if (is_object($parserClass)) {
-            $this->parserClass = get_class($parserClass);
-        } else {
-            $this->parserClass = $parserClass;
+        $environment = $this->createEnvironment();
+
+        if ($this->frontMatter) {
+            $markdown = $this->extractFrontMatter($markdown);
         }
+
+        return $this->parseInternal($environment, $markdown);
     }
 
     /**
-     * Parse text using Markdown and Markdown-Extra
-     * @param string $text Markdown text to parse
-     * @return string Resulting HTML
+     * Parse Markdown content and render as HTML, with unsafe tags disabled.
+     *
+     * This will prevent tags such as <script>, <embed>, <iframe> from being rendered in the HTML
+     * output.
      */
-    public function parse($text)
+    public function parseClean(string $markdown): string
     {
-        return $this->parseInternal($text);
+        $this->safeMode = true;
+        $environment = $this->createEnvironment();
+
+        if ($this->frontMatter) {
+            $markdown = $this->extractFrontMatter($markdown);
+        }
+
+        return $this->parseInternal($environment, $markdown);
     }
 
     /**
-     * Enables safe mode
-     * @param  string $text Markdown text to parse
-     * @return string       Resulting HTML
+     * Parse Markdown content and render as HTML, with indented code blocks disabled.
      */
-    public function parseClean($text)
+    public function parseSafe(string $markdown): string
     {
-        $parser = $this->getParser()->setSafeMode(true);
+        $this->config = array_replace_recursive($this->config, [
+            'commonmark' => [
+                'enable_indented_code_blocks' => false,
+            ],
+        ]);
+        $environment = $this->createEnvironment();
+
+        if ($this->frontMatter) {
+            $markdown = $this->extractFrontMatter($markdown);
+        }
 
-        return $this->parseInternal($text, 'text', $parser);
+        return $this->parseInternal($environment, $markdown);
     }
 
     /**
-     * Disables code blocks caused by indentation.
-     * @param  string $text Markdown text to parse
-     * @return string       Resulting HTML
+     * Parse a single line
+     */
+    public function parseLine(string $markdown): string
+    {
+        $this->safeMode = true;
+        $this->inlineOnly = true;
+        $environment = $this->createEnvironment();
+        return $this->parseInternal($environment, $markdown);
+    }
+
+    /**
+     * Creates a CommonMark environment for each parse.
+     *
+     * The environment will also be extended with the necessary extensions that are needed to
+     * support the features enabled for this instance of the parser.
      */
-    public function parseSafe($text)
+    protected function createEnvironment(): Environment
     {
-        $parser = $this->getParser()->setUnmarkedBlockTypes([]);
+        $config = array_replace($this->getDefaultConfig(), $this->config);
+
+        $environment = new Environment($config);
 
-        return $this->parseInternal($text, 'text', $parser);
+        if (!$this->inlineOnly) {
+            // Add default extensions
+            $environment->addExtension(new CommonMarkCoreExtension);
+            $environment->addExtension(new StrikethroughExtension);
+
+            // Add extensions as necessary
+            if ($this->attributes) {
+                $environment->addExtension(new AttributesExtension);
+            }
+            if ($this->autolinking) {
+                $environment->addExtension(new AutolinkExtension);
+            }
+            if ($this->footnotes) {
+                $environment->addExtension(new FootnoteExtension);
+            }
+            if ($this->frontMatter) {
+                $environment->addExtension(new FrontMatterExtension);
+            }
+            if ($this->headingPermalinks) {
+                $environment->addExtension(new HeadingPermalinkExtension);
+            }
+            if ($this->safeMode) {
+                $environment->addExtension(new DisallowedRawHtmlExtension);
+            }
+            if ($this->taskLists) {
+                $environment->addExtension(new TaskListExtension);
+            }
+            if ($this->tables) {
+                $environment->addExtension(new TableExtension);
+            }
+            if ($this->tableOfContents) {
+                $environment->addExtension(new TableOfContentsExtension);
+            }
+        } else {
+            // Set up a special environment for inline-only mode
+            $environment->addExtension(new InlinesOnlyExtension);
+            $environment->addExtension(new StrikethroughExtension);
+
+            if ($this->attributes) {
+                $environment->addExtension(new AttributesExtension);
+            }
+            if ($this->autolinking) {
+                $environment->addExtension(new AutolinkExtension);
+            }
+        }
+
+        return $environment;
     }
 
     /**
-     * Parse a single line
-     * @param  string $text Markdown text to parse
-     * @return string       Resulting HTML
+     * Returns the default configuration for the Markdown environment.
+     *
+     * @return array
      */
-    public function parseLine($text)
+    protected function getDefaultConfig(): array
     {
-        return $this->parseInternal($text, 'line');
+        return [];
     }
 
     /**
      * Internal method for parsing
      */
-    protected function parseInternal($text, $method = 'text', Parsedown $parser = null)
+    protected function parseInternal(Environment $environment, string $markdown): string
     {
-        if (is_null($parser)) {
-            $parser = $this->getParser();
-        }
-        $data = new MarkdownData($text);
+        $data = new MarkdownData($markdown);
 
         $this->fireEvent('beforeParse', [$data], false);
         Event::fire('markdown.beforeParse', [$data], false);
 
-        $result = $data->text;
+        $markdown = $data->text;
 
-        $result = $parser->$method($result);
+        // Parse the Markdown into a document (abstract syntax tree)
+        $parser = $this->getParser($environment);
+        $document = $parser->parse($markdown);
 
-        $data->text = $result;
+        // Render the AST as a HTML document
+        $renderer = $this->getRenderer($environment);
+        $rendered = $renderer->renderDocument($document);
+
+        $data->text = $rendered;
 
         // The markdown.parse gets passed both the original
         // input and the result so far.
-        $this->fireEvent('parse', [$text, $data], false);
-        Event::fire('markdown.parse', [$text, $data], false);
+        $this->fireEvent('parse', [$markdown, $data], false);
+        Event::fire('markdown.parse', [$markdown, $data], false);
 
         return $data->text;
     }
+
+    /**
+     * Extracts front matter from the Markdown content.
+     *
+     * The content, minus the front matter, is returned.
+     */
+    protected function extractFrontMatter(string $markdown): string
+    {
+        $frontMatterParser = new FrontMatterParser(new SymfonyYamlFrontMatterParser);
+        $parts = $frontMatterParser->parse($markdown);
+        $this->frontMatter = $parts->getFrontMatter() ?? [];
+        $contents = $parts->getContent();
+
+        return $contents;
+    }
+
+    /**
+     * Gets an instance of the Markdown parser within a given environment.
+     */
+    protected function getParser(Environment $environment): MarkdownParserInterface
+    {
+        if (isset($this->parserClass)) {
+            return new $this->parserClass($environment);
+        }
+
+        return new MarkdownParser($environment);
+    }
+
+    /**
+     * Sets the Markdown parser to use.
+     */
+    public function setParser(MarkdownParserInterface $parserClass): void
+    {
+        $this->parserClass = get_class($parserClass);
+    }
+
+    /**
+     * Gets an instance of the HTML renderer within a given environment.
+     */
+    protected function getRenderer(Environment $environment): DocumentRendererInterface
+    {
+        if (isset($this->rendererClass)) {
+            return new $this->rendererClass($environment);
+        }
+
+        return new HtmlRenderer($environment);
+    }
+
+    /**
+     * Sets the HTML renderer to use.
+     */
+    public function setRenderer(DocumentRendererInterface $rendererClass): void
+    {
+        $this->rendererClass = get_class($rendererClass);
+    }
+
+    /**
+     * Allows fluent-style enabling and disabling of features.
+     */
+    public function __call(string $name, array $arguments): static
+    {
+        $enable = true;
+
+        if (str_starts_with($name, 'set')) {
+            $property = lcfirst(str_after($name, 'set'));
+
+            if ($property === 'config') {
+                $enable = (array) $arguments[0];
+            } else {
+                $enable = boolval($arguments[0] ?? true);
+            }
+        } elseif (str_starts_with($name, 'enable')) {
+            $property = lcfirst(str_after($name, 'enable'));
+            $enable = true;
+        } elseif (str_starts_with($name, 'disable')) {
+            $property = lcfirst(str_after($name, 'disable'));
+            $enable = false;
+        }
+
+        if (!isset($property) || !property_exists(static::class, $property)) {
+            throw new \BadMethodCallException(sprintf('Call to undefined method %s::%s()', static::class, $name));
+        }
+
+        $this->{$property} = $enable;
+
+        return $this;
+    }
+
+    /**
+     * Allows fluent-style enabling and disabling of features from an initial static call.
+     */
+    public static function __callStatic(string $name, array $arguments): static
+    {
+        $enable = true;
+
+        if (str_starts_with($name, 'set')) {
+            $property = lcfirst(str_after($name, 'set'));
+
+            if ($property === 'config') {
+                $enable = (array) $arguments[0];
+            } else {
+                $enable = boolval($arguments[0] ?? true);
+            }
+        } elseif (str_starts_with($name, 'enable')) {
+            $property = lcfirst(str_after($name, 'enable'));
+            $enable = true;
+        } elseif (str_starts_with($name, 'disable')) {
+            $property = lcfirst(str_after($name, 'disable'));
+            $enable = false;
+        }
+
+        if (!isset($property) || !property_exists(static::class, $property)) {
+            throw new \BadMethodCallException(sprintf('Call to undefined method %s::%s()', static::class, $name));
+        }
+
+        $instance = new static;
+        $instance->{$property} = $enable;
+
+        return $instance;
+    }
 }
diff --git a/src/Parse/Markdown/CommonMarkCoreExtension.php b/src/Parse/Markdown/CommonMarkCoreExtension.php
new file mode 100644
index 000000000..de3614626
--- /dev/null
+++ b/src/Parse/Markdown/CommonMarkCoreExtension.php
@@ -0,0 +1,174 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package, modified by Winter CMS to allow indented
+ * code blocks to be enabled and disabled.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Winter\Storm\Parse\Markdown;
+
+use League\CommonMark\Environment\EnvironmentBuilderInterface;
+use League\CommonMark\Extension\CommonMark\Delimiter\Processor\EmphasisDelimiterProcessor;
+use League\CommonMark\Extension\ConfigurableExtensionInterface;
+use League\CommonMark\Node as CoreNode;
+use League\CommonMark\Parser as CoreParser;
+use League\CommonMark\Renderer as CoreRenderer;
+use League\Config\ConfigurationBuilderInterface;
+use Nette\Schema\Expect;
+
+final class CommonMarkCoreExtension implements ConfigurableExtensionInterface
+{
+    public function configureSchema(ConfigurationBuilderInterface $builder): void
+    {
+        $builder->addSchema('commonmark', Expect::structure([
+            'use_asterisk' => Expect::bool(true),
+            'use_underscore' => Expect::bool(true),
+            'enable_strong' => Expect::bool(true),
+            'enable_em' => Expect::bool(true),
+            'enable_indented_code_blocks' => Expect::bool(true),
+            'unordered_list_markers' => Expect::listOf('string')->min(1)->default(['*', '+', '-'])->mergeDefaults(false),
+        ]));
+    }
+
+    // phpcs:disable Generic.Functions.FunctionCallArgumentSpacing.TooMuchSpaceAfterComma,Squiz.WhiteSpace.SemicolonSpacing.Incorrect
+    public function register(EnvironmentBuilderInterface $environment): void
+    {
+        $environment
+            // Block start parsers
+            ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\BlockQuoteStartParser(), 70)
+            ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\HeadingStartParser(), 60)
+            ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\FencedCodeStartParser(), 50)
+            ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\HtmlBlockStartParser(), 40)
+            ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\ThematicBreakStartParser(), 20)
+            ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\ListBlockStartParser(), 10)
+
+            // Inline parsers
+            ->addInlineParser(new CoreParser\Inline\NewlineParser(), 200)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\BacktickParser(), 150)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\EscapableParser(), 80)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\EntityParser(), 70)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\AutolinkParser(), 50)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\HtmlInlineParser(), 40)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\CloseBracketParser(), 30)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\OpenBracketParser(), 20)
+            ->addInlineParser(new \League\CommonMark\Extension\CommonMark\Parser\Inline\BangParser(), 10)
+
+            // Block renderers
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\BlockQuote::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\BlockQuoteRenderer(),
+                0
+            )
+            ->addRenderer(
+                CoreNode\Block\Document::class,
+                new CoreRenderer\Block\DocumentRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\FencedCode::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\FencedCodeRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\Heading::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\HeadingRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\HtmlBlock::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\HtmlBlockRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\ListBlock::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\ListBlockRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\ListItem::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\ListItemRenderer(),
+                0
+            )
+            ->addRenderer(
+                CoreNode\Block\Paragraph::class,
+                new CoreRenderer\Block\ParagraphRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Block\ThematicBreak::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Block\ThematicBreakRenderer(),
+                0
+            )
+
+            // Inline renderers
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Inline\Code::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Inline\CodeRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Inline\Emphasis::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Inline\EmphasisRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Inline\HtmlInline::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Inline\HtmlInlineRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Inline\Image::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Inline\ImageRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Inline\Link::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Inline\LinkRenderer(),
+                0
+            )
+            ->addRenderer(
+                CoreNode\Inline\Newline::class,
+                new CoreRenderer\Inline\NewlineRenderer(),
+                0
+            )
+            ->addRenderer(
+                \League\CommonMark\Extension\CommonMark\Node\Inline\Strong::class,
+                new \League\CommonMark\Extension\CommonMark\Renderer\Inline\StrongRenderer(),
+                0
+            )
+            ->addRenderer(
+                CoreNode\Inline\Text::class,
+                new CoreRenderer\Inline\TextRenderer(),
+                0
+            )
+        ;
+
+        if ($environment->getConfiguration()->get('commonmark/enable_indented_code_blocks')) {
+            $environment
+                ->addBlockStartParser(new \League\CommonMark\Extension\CommonMark\Parser\Block\IndentedCodeStartParser(), -100)
+                ->addRenderer(
+                    \League\CommonMark\Extension\CommonMark\Node\Block\IndentedCode::class,
+                    new \League\CommonMark\Extension\CommonMark\Renderer\Block\IndentedCodeRenderer(),
+                    0
+                );
+        }
+
+        if ($environment->getConfiguration()->get('commonmark/use_asterisk')) {
+            $environment->addDelimiterProcessor(new EmphasisDelimiterProcessor('*'));
+        }
+
+        if ($environment->getConfiguration()->get('commonmark/use_underscore')) {
+            $environment->addDelimiterProcessor(new EmphasisDelimiterProcessor('_'));
+        }
+    }
+}
diff --git a/src/Parse/ParseServiceProvider.php b/src/Parse/ParseServiceProvider.php
index 03fb6d906..f69e26229 100644
--- a/src/Parse/ParseServiceProvider.php
+++ b/src/Parse/ParseServiceProvider.php
@@ -1,4 +1,6 @@
-<?php namespace Winter\Storm\Parse;
+<?php
+
+namespace Winter\Storm\Parse;
 
 use Illuminate\Support\ServiceProvider;
 use Winter\Storm\Parse\Processor\Symfony3Processor;
@@ -11,7 +13,6 @@ class ParseServiceProvider extends ServiceProvider
      * @var array
      */
     public $singletons = [
-        'parse.markdown' => Markdown::class,
         'parse.twig' => Twig::class,
         'parse.ini' => Ini::class,
     ];
@@ -22,6 +23,10 @@ class ParseServiceProvider extends ServiceProvider
      */
     public function register()
     {
+        $this->app->bind('parse.markdown', function ($app) {
+            return new Markdown;
+        });
+
         $this->app->singleton('parse.yaml', function ($app) {
             $yaml = new Yaml();
             $yaml->setProcessor(new Symfony3Processor);
diff --git a/src/Parse/Parsedown/Parsedown.php b/src/Parse/Parsedown/Parsedown.php
deleted file mode 100644
index cf0c482c5..000000000
--- a/src/Parse/Parsedown/Parsedown.php
+++ /dev/null
@@ -1,13 +0,0 @@
-<?php namespace Winter\Storm\Parse\Parsedown;
-
-use ParsedownExtra;
-
-class Parsedown extends ParsedownExtra
-{
-    public function setUnmarkedBlockTypes($unmarkedBlockTypes)
-    {
-        $this->unmarkedBlockTypes = $unmarkedBlockTypes;
-
-        return $this;
-    }
-}
diff --git a/src/Support/aliases.php b/src/Support/aliases.php
index a3debf09e..2a2ac773f 100644
--- a/src/Support/aliases.php
+++ b/src/Support/aliases.php
@@ -304,7 +304,6 @@ class_alias(\Winter\Storm\Parse\Bracket::class, \October\Rain\Parse\Bracket::cla
 class_alias(\Winter\Storm\Parse\Ini::class, \October\Rain\Parse\Ini::class);
 class_alias(\Winter\Storm\Parse\Markdown::class, \October\Rain\Parse\Markdown::class);
 class_alias(\Winter\Storm\Parse\MarkdownData::class, \October\Rain\Parse\MarkdownData::class);
-class_alias(\Winter\Storm\Parse\Parsedown\Parsedown::class, \October\Rain\Parse\Parsedown\Parsedown::class);
 class_alias(\Winter\Storm\Parse\ParseServiceProvider::class, \October\Rain\Parse\ParseServiceProvider::class);
 class_alias(\Winter\Storm\Parse\Syntax\FieldParser::class, \October\Rain\Parse\Syntax\FieldParser::class);
 class_alias(\Winter\Storm\Parse\Syntax\Parser::class, \October\Rain\Parse\Syntax\Parser::class);

From 5dc82cc683bc983551eee2d2c8eb32df22c6b841 Mon Sep 17 00:00:00 2001
From: Ben Thomson <git@alfreido.com>
Date: Tue, 22 Nov 2022 16:24:11 +0800
Subject: [PATCH 2/6] Add test cases for Markdown parser, based off Parsedown
 test cases

---
 tests/Parse/MarkdownTest.php                  | 57 +++++++++++++
 tests/fixtures/markdown/README.md             | 25 ++++++
 tests/fixtures/markdown/aesthetic_table.html  | 18 ++++
 tests/fixtures/markdown/aesthetic_table.md    |  4 +
 tests/fixtures/markdown/aligned_table.html    | 21 +++++
 tests/fixtures/markdown/aligned_table.md      |  4 +
 tests/fixtures/markdown/atx_heading.html      | 13 +++
 tests/fixtures/markdown/atx_heading.md        | 25 ++++++
 tests/fixtures/markdown/automatic_link.html   |  1 +
 tests/fixtures/markdown/automatic_link.md     |  1 +
 tests/fixtures/markdown/block-level_html.html | 12 +++
 tests/fixtures/markdown/block-level_html.md   | 16 ++++
 tests/fixtures/markdown/code_block.html       | 13 +++
 tests/fixtures/markdown/code_block.md         | 17 ++++
 .../markdown/code_block_disabled.html         | 10 +++
 tests/fixtures/markdown/code_span.html        |  6 ++
 tests/fixtures/markdown/code_span.md          | 11 +++
 .../markdown/compound_blockquote.html         |  9 ++
 .../fixtures/markdown/compound_blockquote.md  | 10 +++
 .../fixtures/markdown/compound_emphasis.html  |  2 +
 tests/fixtures/markdown/compound_emphasis.md  |  4 +
 tests/fixtures/markdown/compound_list.html    | 12 +++
 tests/fixtures/markdown/compound_list.md      |  7 ++
 .../fixtures/markdown/deeply_nested_list.html | 39 +++++++++
 tests/fixtures/markdown/deeply_nested_list.md | 26 ++++++
 tests/fixtures/markdown/em_strong.html        |  8 ++
 tests/fixtures/markdown/em_strong.md          | 15 ++++
 tests/fixtures/markdown/email.html            |  3 +
 tests/fixtures/markdown/email.md              |  5 ++
 tests/fixtures/markdown/emphasis.html         |  8 ++
 tests/fixtures/markdown/emphasis.md           | 13 +++
 tests/fixtures/markdown/escaping.html         |  6 ++
 tests/fixtures/markdown/escaping.md           | 11 +++
 .../fixtures/markdown/fenced_code_block.html  | 18 ++++
 tests/fixtures/markdown/fenced_code_block.md  | 38 +++++++++
 tests/fixtures/markdown/horizontal_rule.html  |  5 ++
 tests/fixtures/markdown/horizontal_rule.md    |  9 ++
 tests/fixtures/markdown/html_comment.html     | 11 +++
 tests/fixtures/markdown/html_comment.md       | 14 ++++
 tests/fixtures/markdown/html_entity.html      |  1 +
 tests/fixtures/markdown/html_entity.md        |  1 +
 tests/fixtures/markdown/image_reference.html  |  2 +
 tests/fixtures/markdown/image_reference.md    |  5 ++
 tests/fixtures/markdown/image_title.html      |  2 +
 tests/fixtures/markdown/image_title.md        |  3 +
 .../fixtures/markdown/implicit_reference.html |  4 +
 tests/fixtures/markdown/implicit_reference.md | 13 +++
 tests/fixtures/markdown/inline_link.html      |  7 ++
 tests/fixtures/markdown/inline_link.md        | 13 +++
 .../fixtures/markdown/inline_link_title.html  |  6 ++
 tests/fixtures/markdown/inline_link_title.md  | 11 +++
 tests/fixtures/markdown/inline_title.html     |  1 +
 tests/fixtures/markdown/inline_title.md       |  1 +
 tests/fixtures/markdown/lazy_blockquote.html  |  8 ++
 tests/fixtures/markdown/lazy_blockquote.md    |  5 ++
 tests/fixtures/markdown/lazy_list.html        |  4 +
 tests/fixtures/markdown/lazy_list.md          |  2 +
 tests/fixtures/markdown/line_break.html       |  2 +
 tests/fixtures/markdown/line_break.md         |  2 +
 .../markdown/markup_consecutive_one.html      |  3 +
 .../markdown/markup_consecutive_one.md        |  4 +
 .../markdown/markup_consecutive_one_line.html |  4 +
 .../markdown/markup_consecutive_one_line.md   |  5 ++
 .../markup_consecutive_one_stripped.html      |  3 +
 .../markup_consecutive_one_stripped.md        |  4 +
 .../markdown/markup_consecutive_two.html      |  3 +
 .../markdown/markup_consecutive_two.md        |  4 +
 .../markup_consecutive_two_lines.html         |  4 +
 .../markdown/markup_consecutive_two_lines.md  |  5 ++
 .../markup_consecutive_two_stripped.html      |  4 +
 .../markup_consecutive_two_stripped.md        |  5 ++
 .../markdown/multiline_list_paragraph.html    |  7 ++
 .../markdown/multiline_list_paragraph.md      |  4 +
 tests/fixtures/markdown/multiline_lists.html  | 10 +++
 tests/fixtures/markdown/multiline_lists.md    |  5 ++
 .../markdown/nested_block-level_html.html     | 10 +++
 .../markdown/nested_block-level_html.md       | 11 +++
 tests/fixtures/markdown/ordered_list.html     | 16 ++++
 tests/fixtures/markdown/ordered_list.md       | 15 ++++
 tests/fixtures/markdown/paragraph_list.html   | 14 ++++
 tests/fixtures/markdown/paragraph_list.md     |  9 ++
 tests/fixtures/markdown/reference_title.html  |  2 +
 tests/fixtures/markdown/reference_title.md    |  6 ++
 .../fixtures/markdown/self-closing_html.html  | 12 +++
 tests/fixtures/markdown/self-closing_html.md  | 18 ++++
 .../markdown/separated_nested_list.html       |  9 ++
 .../markdown/separated_nested_list.md         |  4 +
 tests/fixtures/markdown/setext_header.html    |  5 ++
 tests/fixtures/markdown/setext_header.md      | 12 +++
 .../markdown/setext_header_spaces.html        | 12 +++
 .../fixtures/markdown/setext_header_spaces.md | 29 +++++++
 .../fixtures/markdown/simple_blockquote.html  | 26 ++++++
 tests/fixtures/markdown/simple_blockquote.md  | 13 +++
 tests/fixtures/markdown/simple_table.html     | 83 +++++++++++++++++++
 tests/fixtures/markdown/simple_table.md       | 50 +++++++++++
 tests/fixtures/markdown/span-level_html.html  |  6 ++
 tests/fixtures/markdown/span-level_html.md    | 10 +++
 .../fixtures/markdown/sparse_dense_list.html  | 11 +++
 tests/fixtures/markdown/sparse_dense_list.md  |  4 +
 tests/fixtures/markdown/sparse_html.html      |  6 ++
 tests/fixtures/markdown/sparse_html.md        |  8 ++
 tests/fixtures/markdown/sparse_list.html      | 17 ++++
 tests/fixtures/markdown/sparse_list.md        |  9 ++
 .../fixtures/markdown/special_characters.html |  6 ++
 tests/fixtures/markdown/special_characters.md | 13 +++
 tests/fixtures/markdown/strikethrough.html    |  4 +
 tests/fixtures/markdown/strikethrough.md      |  7 ++
 tests/fixtures/markdown/strong_em.html        |  6 ++
 tests/fixtures/markdown/strong_em.md          | 11 +++
 .../markdown/tab-indented_code_block.html     |  6 ++
 .../markdown/tab-indented_code_block.md       |  6 ++
 .../markdown/table_inline_markdown.html       | 26 ++++++
 .../markdown/table_inline_markdown.md         |  6 ++
 tests/fixtures/markdown/text_reference.html   |  8 ++
 tests/fixtures/markdown/text_reference.md     | 21 +++++
 tests/fixtures/markdown/unordered_list.html   | 22 +++++
 tests/fixtures/markdown/unordered_list.md     | 14 ++++
 tests/fixtures/markdown/untidy_table.html     | 18 ++++
 tests/fixtures/markdown/untidy_table.md       |  4 +
 tests/fixtures/markdown/url_autolinking.html  |  3 +
 tests/fixtures/markdown/url_autolinking.md    |  5 ++
 tests/fixtures/markdown/whitespace.html       |  1 +
 tests/fixtures/markdown/whitespace.md         |  5 ++
 123 files changed, 1313 insertions(+)
 create mode 100644 tests/Parse/MarkdownTest.php
 create mode 100644 tests/fixtures/markdown/README.md
 create mode 100644 tests/fixtures/markdown/aesthetic_table.html
 create mode 100644 tests/fixtures/markdown/aesthetic_table.md
 create mode 100644 tests/fixtures/markdown/aligned_table.html
 create mode 100644 tests/fixtures/markdown/aligned_table.md
 create mode 100644 tests/fixtures/markdown/atx_heading.html
 create mode 100644 tests/fixtures/markdown/atx_heading.md
 create mode 100644 tests/fixtures/markdown/automatic_link.html
 create mode 100644 tests/fixtures/markdown/automatic_link.md
 create mode 100644 tests/fixtures/markdown/block-level_html.html
 create mode 100644 tests/fixtures/markdown/block-level_html.md
 create mode 100644 tests/fixtures/markdown/code_block.html
 create mode 100644 tests/fixtures/markdown/code_block.md
 create mode 100644 tests/fixtures/markdown/code_block_disabled.html
 create mode 100644 tests/fixtures/markdown/code_span.html
 create mode 100644 tests/fixtures/markdown/code_span.md
 create mode 100644 tests/fixtures/markdown/compound_blockquote.html
 create mode 100644 tests/fixtures/markdown/compound_blockquote.md
 create mode 100644 tests/fixtures/markdown/compound_emphasis.html
 create mode 100644 tests/fixtures/markdown/compound_emphasis.md
 create mode 100644 tests/fixtures/markdown/compound_list.html
 create mode 100644 tests/fixtures/markdown/compound_list.md
 create mode 100644 tests/fixtures/markdown/deeply_nested_list.html
 create mode 100644 tests/fixtures/markdown/deeply_nested_list.md
 create mode 100644 tests/fixtures/markdown/em_strong.html
 create mode 100644 tests/fixtures/markdown/em_strong.md
 create mode 100644 tests/fixtures/markdown/email.html
 create mode 100644 tests/fixtures/markdown/email.md
 create mode 100644 tests/fixtures/markdown/emphasis.html
 create mode 100644 tests/fixtures/markdown/emphasis.md
 create mode 100644 tests/fixtures/markdown/escaping.html
 create mode 100644 tests/fixtures/markdown/escaping.md
 create mode 100644 tests/fixtures/markdown/fenced_code_block.html
 create mode 100644 tests/fixtures/markdown/fenced_code_block.md
 create mode 100644 tests/fixtures/markdown/horizontal_rule.html
 create mode 100644 tests/fixtures/markdown/horizontal_rule.md
 create mode 100644 tests/fixtures/markdown/html_comment.html
 create mode 100644 tests/fixtures/markdown/html_comment.md
 create mode 100644 tests/fixtures/markdown/html_entity.html
 create mode 100644 tests/fixtures/markdown/html_entity.md
 create mode 100644 tests/fixtures/markdown/image_reference.html
 create mode 100644 tests/fixtures/markdown/image_reference.md
 create mode 100644 tests/fixtures/markdown/image_title.html
 create mode 100644 tests/fixtures/markdown/image_title.md
 create mode 100644 tests/fixtures/markdown/implicit_reference.html
 create mode 100644 tests/fixtures/markdown/implicit_reference.md
 create mode 100644 tests/fixtures/markdown/inline_link.html
 create mode 100644 tests/fixtures/markdown/inline_link.md
 create mode 100644 tests/fixtures/markdown/inline_link_title.html
 create mode 100644 tests/fixtures/markdown/inline_link_title.md
 create mode 100644 tests/fixtures/markdown/inline_title.html
 create mode 100644 tests/fixtures/markdown/inline_title.md
 create mode 100644 tests/fixtures/markdown/lazy_blockquote.html
 create mode 100644 tests/fixtures/markdown/lazy_blockquote.md
 create mode 100644 tests/fixtures/markdown/lazy_list.html
 create mode 100644 tests/fixtures/markdown/lazy_list.md
 create mode 100644 tests/fixtures/markdown/line_break.html
 create mode 100644 tests/fixtures/markdown/line_break.md
 create mode 100644 tests/fixtures/markdown/markup_consecutive_one.html
 create mode 100644 tests/fixtures/markdown/markup_consecutive_one.md
 create mode 100644 tests/fixtures/markdown/markup_consecutive_one_line.html
 create mode 100644 tests/fixtures/markdown/markup_consecutive_one_line.md
 create mode 100644 tests/fixtures/markdown/markup_consecutive_one_stripped.html
 create mode 100644 tests/fixtures/markdown/markup_consecutive_one_stripped.md
 create mode 100644 tests/fixtures/markdown/markup_consecutive_two.html
 create mode 100644 tests/fixtures/markdown/markup_consecutive_two.md
 create mode 100644 tests/fixtures/markdown/markup_consecutive_two_lines.html
 create mode 100644 tests/fixtures/markdown/markup_consecutive_two_lines.md
 create mode 100644 tests/fixtures/markdown/markup_consecutive_two_stripped.html
 create mode 100644 tests/fixtures/markdown/markup_consecutive_two_stripped.md
 create mode 100644 tests/fixtures/markdown/multiline_list_paragraph.html
 create mode 100644 tests/fixtures/markdown/multiline_list_paragraph.md
 create mode 100644 tests/fixtures/markdown/multiline_lists.html
 create mode 100644 tests/fixtures/markdown/multiline_lists.md
 create mode 100644 tests/fixtures/markdown/nested_block-level_html.html
 create mode 100644 tests/fixtures/markdown/nested_block-level_html.md
 create mode 100644 tests/fixtures/markdown/ordered_list.html
 create mode 100644 tests/fixtures/markdown/ordered_list.md
 create mode 100644 tests/fixtures/markdown/paragraph_list.html
 create mode 100644 tests/fixtures/markdown/paragraph_list.md
 create mode 100644 tests/fixtures/markdown/reference_title.html
 create mode 100644 tests/fixtures/markdown/reference_title.md
 create mode 100644 tests/fixtures/markdown/self-closing_html.html
 create mode 100644 tests/fixtures/markdown/self-closing_html.md
 create mode 100644 tests/fixtures/markdown/separated_nested_list.html
 create mode 100644 tests/fixtures/markdown/separated_nested_list.md
 create mode 100644 tests/fixtures/markdown/setext_header.html
 create mode 100644 tests/fixtures/markdown/setext_header.md
 create mode 100644 tests/fixtures/markdown/setext_header_spaces.html
 create mode 100644 tests/fixtures/markdown/setext_header_spaces.md
 create mode 100644 tests/fixtures/markdown/simple_blockquote.html
 create mode 100644 tests/fixtures/markdown/simple_blockquote.md
 create mode 100644 tests/fixtures/markdown/simple_table.html
 create mode 100644 tests/fixtures/markdown/simple_table.md
 create mode 100644 tests/fixtures/markdown/span-level_html.html
 create mode 100644 tests/fixtures/markdown/span-level_html.md
 create mode 100644 tests/fixtures/markdown/sparse_dense_list.html
 create mode 100644 tests/fixtures/markdown/sparse_dense_list.md
 create mode 100644 tests/fixtures/markdown/sparse_html.html
 create mode 100644 tests/fixtures/markdown/sparse_html.md
 create mode 100644 tests/fixtures/markdown/sparse_list.html
 create mode 100644 tests/fixtures/markdown/sparse_list.md
 create mode 100644 tests/fixtures/markdown/special_characters.html
 create mode 100644 tests/fixtures/markdown/special_characters.md
 create mode 100644 tests/fixtures/markdown/strikethrough.html
 create mode 100644 tests/fixtures/markdown/strikethrough.md
 create mode 100644 tests/fixtures/markdown/strong_em.html
 create mode 100644 tests/fixtures/markdown/strong_em.md
 create mode 100644 tests/fixtures/markdown/tab-indented_code_block.html
 create mode 100644 tests/fixtures/markdown/tab-indented_code_block.md
 create mode 100644 tests/fixtures/markdown/table_inline_markdown.html
 create mode 100644 tests/fixtures/markdown/table_inline_markdown.md
 create mode 100644 tests/fixtures/markdown/text_reference.html
 create mode 100644 tests/fixtures/markdown/text_reference.md
 create mode 100644 tests/fixtures/markdown/unordered_list.html
 create mode 100644 tests/fixtures/markdown/unordered_list.md
 create mode 100644 tests/fixtures/markdown/untidy_table.html
 create mode 100644 tests/fixtures/markdown/untidy_table.md
 create mode 100644 tests/fixtures/markdown/url_autolinking.html
 create mode 100644 tests/fixtures/markdown/url_autolinking.md
 create mode 100644 tests/fixtures/markdown/whitespace.html
 create mode 100644 tests/fixtures/markdown/whitespace.md

diff --git a/tests/Parse/MarkdownTest.php b/tests/Parse/MarkdownTest.php
new file mode 100644
index 000000000..1c667dcfd
--- /dev/null
+++ b/tests/Parse/MarkdownTest.php
@@ -0,0 +1,57 @@
+<?php
+
+use Winter\Storm\Support\Facades\Markdown;
+
+class MarkdownTest extends TestCase
+{
+    /**
+     * @dataProvider markdownData
+     * @param string $name
+     * @param string $markdown
+     * @param string $html
+     * @return void
+     */
+    public function testParse($name, $markdown, $html)
+    {
+        $this->assertEquals($html, $this->removeLineEndings(Markdown::parse($markdown)), 'Markdown test case "' . $name . '" failed');
+    }
+
+    public function testParseSafe()
+    {
+        $markdown = file_get_contents(dirname(__DIR__) . '/fixtures/markdown/code_block.md');
+        $html = $this->removeLineEndings(file_get_contents(dirname(__DIR__) . '/fixtures/markdown/code_block_disabled.html'));
+
+        $this->assertEquals($html, $this->removeLineEndings(Markdown::parseSafe($markdown)));
+    }
+
+    /**
+     * Data provider to provide test cases for Markdown parsing.
+     *
+     * @return array
+     */
+    public function markdownData()
+    {
+        $dirName = dirname(__DIR__) . '/fixtures/markdown';
+        $dir = new DirectoryIterator($dirName);
+
+        foreach ($dir as $file) {
+            if ($file->isFile() && $file->getExtension() === 'md') {
+                $name = $file->getBasename('.md');
+
+                if ($name === 'README') {
+                    continue;
+                }
+
+                $markdown = file_get_contents($dirName . DIRECTORY_SEPARATOR . $name . '.md');
+                $html = $this->removeLineEndings(file_get_contents($dirName . DIRECTORY_SEPARATOR . $name . '.html'));
+
+                yield [$name, $markdown, $html];
+            }
+        }
+    }
+
+    protected function removeLineEndings(string $text)
+    {
+        return str_replace(["\r\n", "\r", "\n"], '', $text);
+    }
+}
diff --git a/tests/fixtures/markdown/README.md b/tests/fixtures/markdown/README.md
new file mode 100644
index 000000000..3bdd26119
--- /dev/null
+++ b/tests/fixtures/markdown/README.md
@@ -0,0 +1,25 @@
+Test cases in this folder are courtesy of the Parsedown library by @erusev and contributors.
+https://github.com/erusev/parsedown
+
+---
+
+The MIT License (MIT)
+
+Copyright (c) 2013-2018 Emanuil Rusev, erusev.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
diff --git a/tests/fixtures/markdown/aesthetic_table.html b/tests/fixtures/markdown/aesthetic_table.html
new file mode 100644
index 000000000..88e1c2bd4
--- /dev/null
+++ b/tests/fixtures/markdown/aesthetic_table.html
@@ -0,0 +1,18 @@
+<table>
+<thead>
+<tr>
+<th>header 1</th>
+<th>header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>cell 1.1</td>
+<td>cell 1.2</td>
+</tr>
+<tr>
+<td>cell 2.1</td>
+<td>cell 2.2</td>
+</tr>
+</tbody>
+</table>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/aesthetic_table.md b/tests/fixtures/markdown/aesthetic_table.md
new file mode 100644
index 000000000..5245e6c9d
--- /dev/null
+++ b/tests/fixtures/markdown/aesthetic_table.md
@@ -0,0 +1,4 @@
+| header 1 | header 2 |
+| -------- | -------- |
+| cell 1.1 | cell 1.2 |
+| cell 2.1 | cell 2.2 |
\ No newline at end of file
diff --git a/tests/fixtures/markdown/aligned_table.html b/tests/fixtures/markdown/aligned_table.html
new file mode 100644
index 000000000..4c1d319c5
--- /dev/null
+++ b/tests/fixtures/markdown/aligned_table.html
@@ -0,0 +1,21 @@
+<table>
+<thead>
+<tr>
+<th align="left">header 1</th>
+<th align="center">header 2</th>
+<th align="right">header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td align="left">cell 1.1</td>
+<td align="center">cell 1.2</td>
+<td align="right">cell 1.3</td>
+</tr>
+<tr>
+<td align="left">cell 2.1</td>
+<td align="center">cell 2.2</td>
+<td align="right">cell 2.3</td>
+</tr>
+</tbody>
+</table>
diff --git a/tests/fixtures/markdown/aligned_table.md b/tests/fixtures/markdown/aligned_table.md
new file mode 100644
index 000000000..69a45f90f
--- /dev/null
+++ b/tests/fixtures/markdown/aligned_table.md
@@ -0,0 +1,4 @@
+| header 1 | header 2 | header 2 |
+| :------- | :------: | -------: |
+| cell 1.1 | cell 1.2 | cell 1.3 |
+| cell 2.1 | cell 2.2 | cell 2.3 |
\ No newline at end of file
diff --git a/tests/fixtures/markdown/atx_heading.html b/tests/fixtures/markdown/atx_heading.html
new file mode 100644
index 000000000..44ceafa8d
--- /dev/null
+++ b/tests/fixtures/markdown/atx_heading.html
@@ -0,0 +1,13 @@
+<h1>h1</h1>
+<h2>h2</h2>
+<h3>h3</h3>
+<h4>h4</h4>
+<h5>h5</h5>
+<h6>h6</h6>
+<p>####### not a heading</p>
+<h1>closed h1</h1>
+<h1></h1>
+<h2></h2>
+<h1># of levels</h1>
+<h1># of levels #</h1>
+<p>#not a heading</p>
diff --git a/tests/fixtures/markdown/atx_heading.md b/tests/fixtures/markdown/atx_heading.md
new file mode 100644
index 000000000..87550df9d
--- /dev/null
+++ b/tests/fixtures/markdown/atx_heading.md
@@ -0,0 +1,25 @@
+# h1
+
+## h2
+
+### h3
+
+#### h4
+
+##### h5
+
+###### h6
+
+####### not a heading
+
+# closed h1 #
+
+#
+
+##
+
+# # of levels
+
+# # of levels # #
+
+#not a heading
diff --git a/tests/fixtures/markdown/automatic_link.html b/tests/fixtures/markdown/automatic_link.html
new file mode 100644
index 000000000..50a94ba0f
--- /dev/null
+++ b/tests/fixtures/markdown/automatic_link.html
@@ -0,0 +1 @@
+<p><a href="http://example.com">http://example.com</a></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/automatic_link.md b/tests/fixtures/markdown/automatic_link.md
new file mode 100644
index 000000000..08d3bf46a
--- /dev/null
+++ b/tests/fixtures/markdown/automatic_link.md
@@ -0,0 +1 @@
+<http://example.com>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/block-level_html.html b/tests/fixtures/markdown/block-level_html.html
new file mode 100644
index 000000000..6443a4a6a
--- /dev/null
+++ b/tests/fixtures/markdown/block-level_html.html
@@ -0,0 +1,12 @@
+<div>_content_</div>
+<p>paragraph</p>
+<div>
+  <div class="inner">
+    _content_
+  </div>
+</div>
+<style type="text/css">
+  p {color: #789;}
+</style>
+<div>
+  <a href="/">home</a></div>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/block-level_html.md b/tests/fixtures/markdown/block-level_html.md
new file mode 100644
index 000000000..17cbc22d3
--- /dev/null
+++ b/tests/fixtures/markdown/block-level_html.md
@@ -0,0 +1,16 @@
+<div>_content_</div>
+
+paragraph
+
+<div>
+  <div class="inner">
+    _content_
+  </div>
+</div>
+
+<style type="text/css">
+  p {color: #789;}
+</style>
+
+<div>
+  <a href="/">home</a></div>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/code_block.html b/tests/fixtures/markdown/code_block.html
new file mode 100644
index 000000000..a186e9afd
--- /dev/null
+++ b/tests/fixtures/markdown/code_block.html
@@ -0,0 +1,13 @@
+<pre><code>&lt;?php
+
+$message = 'Hello World!';
+echo $message;</code></pre>
+<hr />
+<pre><code>&gt; not a quote
+- not a list item
+[not a reference]: http://foo.com</code></pre>
+<hr />
+<pre><code>foo
+
+
+bar</code></pre>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/code_block.md b/tests/fixtures/markdown/code_block.md
new file mode 100644
index 000000000..badf87326
--- /dev/null
+++ b/tests/fixtures/markdown/code_block.md
@@ -0,0 +1,17 @@
+    <?php
+
+    $message = 'Hello World!';
+    echo $message;
+
+---
+
+    > not a quote
+    - not a list item
+    [not a reference]: http://foo.com
+
+---
+
+    foo
+
+
+    bar
\ No newline at end of file
diff --git a/tests/fixtures/markdown/code_block_disabled.html b/tests/fixtures/markdown/code_block_disabled.html
new file mode 100644
index 000000000..a1dd241ba
--- /dev/null
+++ b/tests/fixtures/markdown/code_block_disabled.html
@@ -0,0 +1,10 @@
+<p>&lt;?php</p>
+<p>$message = 'Hello World!';
+echo $message;</p>
+<hr />
+<p>&gt; not a quote
+- not a list item
+[not a reference]: <a href="http://foo.com">http://foo.com</a></p>
+<hr />
+<p>foo</p>
+<p>bar</p>
diff --git a/tests/fixtures/markdown/code_span.html b/tests/fixtures/markdown/code_span.html
new file mode 100644
index 000000000..5c4c231e3
--- /dev/null
+++ b/tests/fixtures/markdown/code_span.html
@@ -0,0 +1,6 @@
+<p>a <code>code span</code></p>
+<p><code>this is also a codespan</code> trailing text</p>
+<p><code>and look at this one!</code></p>
+<p>single backtick in a code span: <code>`</code></p>
+<p>backtick-delimited string in a code span: <code>`foo`</code></p>
+<p><code>sth `` sth</code></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/code_span.md b/tests/fixtures/markdown/code_span.md
new file mode 100644
index 000000000..c2f1a7442
--- /dev/null
+++ b/tests/fixtures/markdown/code_span.md
@@ -0,0 +1,11 @@
+a `code span`
+
+`this is also a codespan` trailing text
+
+`and look at this one!`
+
+single backtick in a code span: `` ` ``
+
+backtick-delimited string in a code span: `` `foo` ``
+
+`sth `` sth`
\ No newline at end of file
diff --git a/tests/fixtures/markdown/compound_blockquote.html b/tests/fixtures/markdown/compound_blockquote.html
new file mode 100644
index 000000000..37afb57a4
--- /dev/null
+++ b/tests/fixtures/markdown/compound_blockquote.html
@@ -0,0 +1,9 @@
+<blockquote>
+<h2>header</h2>
+<p>paragraph</p>
+<ul>
+<li>li</li>
+</ul>
+<hr />
+<p>paragraph</p>
+</blockquote>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/compound_blockquote.md b/tests/fixtures/markdown/compound_blockquote.md
new file mode 100644
index 000000000..80c4aed16
--- /dev/null
+++ b/tests/fixtures/markdown/compound_blockquote.md
@@ -0,0 +1,10 @@
+> header
+> ------
+>
+> paragraph
+>
+> - li
+>
+> ---
+>
+> paragraph
\ No newline at end of file
diff --git a/tests/fixtures/markdown/compound_emphasis.html b/tests/fixtures/markdown/compound_emphasis.html
new file mode 100644
index 000000000..178dd54ba
--- /dev/null
+++ b/tests/fixtures/markdown/compound_emphasis.html
@@ -0,0 +1,2 @@
+<p><em><code>code</code></em> <strong><code>code</code></strong></p>
+<p><em><code>code</code><strong><code>code</code></strong><code>code</code></em></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/compound_emphasis.md b/tests/fixtures/markdown/compound_emphasis.md
new file mode 100644
index 000000000..6fe07f260
--- /dev/null
+++ b/tests/fixtures/markdown/compound_emphasis.md
@@ -0,0 +1,4 @@
+_`code`_ __`code`__
+
+*`code`**`code`**`code`*
+
diff --git a/tests/fixtures/markdown/compound_list.html b/tests/fixtures/markdown/compound_list.html
new file mode 100644
index 000000000..f5593c142
--- /dev/null
+++ b/tests/fixtures/markdown/compound_list.html
@@ -0,0 +1,12 @@
+<ul>
+<li>
+<p>paragraph</p>
+<p>paragraph</p>
+</li>
+<li>
+<p>paragraph</p>
+<blockquote>
+<p>quote</p>
+</blockquote>
+</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/compound_list.md b/tests/fixtures/markdown/compound_list.md
new file mode 100644
index 000000000..ed7f0c60f
--- /dev/null
+++ b/tests/fixtures/markdown/compound_list.md
@@ -0,0 +1,7 @@
+- paragraph
+
+  paragraph
+
+- paragraph
+
+  > quote
\ No newline at end of file
diff --git a/tests/fixtures/markdown/deeply_nested_list.html b/tests/fixtures/markdown/deeply_nested_list.html
new file mode 100644
index 000000000..6dec00b76
--- /dev/null
+++ b/tests/fixtures/markdown/deeply_nested_list.html
@@ -0,0 +1,39 @@
+<ul>
+<li>li<ul>
+<li>li<ul>
+<li>li</li>
+<li>li</li>
+</ul>
+</li>
+<li>li</li>
+</ul>
+</li>
+<li>li</li>
+</ul>
+<hr />
+<ul>
+<li>level 1<ul>
+<li>level 2<ul>
+<li>level 3<ul>
+<li>level 4<ul>
+<li>level 5</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+<hr />
+<ul>
+<li>a</li>
+<li>b</li>
+<li>c</li>
+<li>d- e</li>
+<li>f</li>
+<li>g</li>
+<li>h</li>
+<li>i</li>
+</ul>
diff --git a/tests/fixtures/markdown/deeply_nested_list.md b/tests/fixtures/markdown/deeply_nested_list.md
new file mode 100644
index 000000000..5da262793
--- /dev/null
+++ b/tests/fixtures/markdown/deeply_nested_list.md
@@ -0,0 +1,26 @@
+- li
+    - li
+        - li
+        - li
+    - li
+- li
+
+---
+
+- level 1
+  - level 2
+    - level 3
+      - level 4
+        - level 5
+
+---
+
+- a
+ - b
+  - c
+   - d
+    - e
+   - f
+  - g
+ - h
+- i
diff --git a/tests/fixtures/markdown/em_strong.html b/tests/fixtures/markdown/em_strong.html
new file mode 100644
index 000000000..c079abd68
--- /dev/null
+++ b/tests/fixtures/markdown/em_strong.html
@@ -0,0 +1,8 @@
+<p><em><strong>em strong</strong></em></p>
+<p><strong><em>em strong</em> strong</strong></p>
+<p><strong>strong <em>em strong</em></strong></p>
+<p><strong>strong <em>em strong</em> strong</strong></p>
+<p><em><strong>em strong</strong></em></p>
+<p><strong><em>em strong</em> strong</strong></p>
+<p><strong>strong <em>em strong</em></strong></p>
+<p><strong>strong <em>em strong</em> strong</strong></p>
diff --git a/tests/fixtures/markdown/em_strong.md b/tests/fixtures/markdown/em_strong.md
new file mode 100644
index 000000000..9abeb3fd4
--- /dev/null
+++ b/tests/fixtures/markdown/em_strong.md
@@ -0,0 +1,15 @@
+___em strong___
+
+___em strong_ strong__
+
+__strong _em strong___
+
+__strong _em strong_ strong__
+
+***em strong***
+
+***em strong* strong**
+
+**strong *em strong***
+
+**strong *em strong* strong**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/email.html b/tests/fixtures/markdown/email.html
new file mode 100644
index 000000000..9f881a337
--- /dev/null
+++ b/tests/fixtures/markdown/email.html
@@ -0,0 +1,3 @@
+<p>my email is <a href="mailto:me@example.com">me@example.com</a></p>
+<p>i can also be reached at <a href="mailto:me@aswell.com">me@aswell.com</a></p>
+<p>email link inside html <strong><a href="mailto:first.last@example.com">first.last@example.com</a></strong></p>
diff --git a/tests/fixtures/markdown/email.md b/tests/fixtures/markdown/email.md
new file mode 100644
index 000000000..957806e7c
--- /dev/null
+++ b/tests/fixtures/markdown/email.md
@@ -0,0 +1,5 @@
+my email is <me@example.com>
+
+i can also be reached at me@aswell.com
+
+email link inside html <strong>first.last@example.com</strong>
diff --git a/tests/fixtures/markdown/emphasis.html b/tests/fixtures/markdown/emphasis.html
new file mode 100644
index 000000000..99233bf76
--- /dev/null
+++ b/tests/fixtures/markdown/emphasis.html
@@ -0,0 +1,8 @@
+<p><em>underscore</em>, <em>asterisk</em>, <em>one two</em>, <em>three four</em>, <em>a</em>, <em>b</em></p>
+<p><strong>strong</strong> and <em>em</em> and <strong>strong</strong> and <em>em</em></p>
+<p><em>line
+line
+line</em></p>
+<p>this_is_not_an_emphasis</p>
+<p>an empty emphasis __ ** is not an emphasis</p>
+<p><em>mixed <em><em>double and</em> single asterisk</em></em> spans</p>
diff --git a/tests/fixtures/markdown/emphasis.md b/tests/fixtures/markdown/emphasis.md
new file mode 100644
index 000000000..85b9d2299
--- /dev/null
+++ b/tests/fixtures/markdown/emphasis.md
@@ -0,0 +1,13 @@
+_underscore_, *asterisk*, _one two_, *three four*, _a_, *b*
+
+**strong** and *em* and **strong** and *em*
+
+_line
+line
+line_
+
+this_is_not_an_emphasis
+
+an empty emphasis __ ** is not an emphasis
+
+*mixed **double and* single asterisk** spans
\ No newline at end of file
diff --git a/tests/fixtures/markdown/escaping.html b/tests/fixtures/markdown/escaping.html
new file mode 100644
index 000000000..0be61b1e4
--- /dev/null
+++ b/tests/fixtures/markdown/escaping.html
@@ -0,0 +1,6 @@
+<p>escaped *emphasis*.</p>
+<p><code>escaped \*emphasis\* in a code span</code></p>
+<pre><code>escaped \*emphasis\* in a code block</code></pre>
+<p>\ ` * _ { } [ ] ( ) &gt; # + - . !</p>
+<p><em>one_two</em> <strong>one_two</strong></p>
+<p><em>one*two</em> <strong>one*two</strong></p>
diff --git a/tests/fixtures/markdown/escaping.md b/tests/fixtures/markdown/escaping.md
new file mode 100644
index 000000000..9f174e98c
--- /dev/null
+++ b/tests/fixtures/markdown/escaping.md
@@ -0,0 +1,11 @@
+escaped \*emphasis\*.
+
+`escaped \*emphasis\* in a code span`
+
+    escaped \*emphasis\* in a code block
+
+\\ \` \* \_ \{ \} \[ \] \( \) \> \# \+ \- \. \!
+
+_one\_two_ __one\_two__
+
+*one\*two* **one\*two**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/fenced_code_block.html b/tests/fixtures/markdown/fenced_code_block.html
new file mode 100644
index 000000000..dc08918b9
--- /dev/null
+++ b/tests/fixtures/markdown/fenced_code_block.html
@@ -0,0 +1,18 @@
+<pre><code>&lt;?php
+
+$message = 'fenced code block';
+echo $message;</code></pre>
+<pre><code>tilde</code></pre>
+<pre><code class="language-php">echo 'language identifier';</code></pre>
+<pre><code class="language-c#">echo 'language identifier with non words';</code></pre>
+<pre><code class="language-html+php">&lt;?php
+echo &quot;Hello World&quot;;
+?&gt;
+&lt;a href=&quot;http://auraphp.com&quot; &gt;Aura Project&lt;/a&gt;</code></pre>
+<pre><code>the following isn't quite enough to close
+```
+still a fenced code block</code></pre>
+<pre><code>foo
+
+
+bar</code></pre>
diff --git a/tests/fixtures/markdown/fenced_code_block.md b/tests/fixtures/markdown/fenced_code_block.md
new file mode 100644
index 000000000..3e4155a88
--- /dev/null
+++ b/tests/fixtures/markdown/fenced_code_block.md
@@ -0,0 +1,38 @@
+```
+<?php
+
+$message = 'fenced code block';
+echo $message;
+```
+
+~~~
+tilde
+~~~
+
+```php
+echo 'language identifier';
+```
+
+```c#
+echo 'language identifier with non words';
+```
+
+```html+php
+<?php
+echo "Hello World";
+?>
+<a href="http://auraphp.com" >Aura Project</a>
+```
+
+````
+the following isn't quite enough to close
+```
+still a fenced code block
+````
+
+```
+foo
+
+
+bar
+```
\ No newline at end of file
diff --git a/tests/fixtures/markdown/horizontal_rule.html b/tests/fixtures/markdown/horizontal_rule.html
new file mode 100644
index 000000000..68da03d06
--- /dev/null
+++ b/tests/fixtures/markdown/horizontal_rule.html
@@ -0,0 +1,5 @@
+<hr />
+<hr />
+<hr />
+<hr />
+<hr />
\ No newline at end of file
diff --git a/tests/fixtures/markdown/horizontal_rule.md b/tests/fixtures/markdown/horizontal_rule.md
new file mode 100644
index 000000000..bf461a925
--- /dev/null
+++ b/tests/fixtures/markdown/horizontal_rule.md
@@ -0,0 +1,9 @@
+---
+
+- - -
+
+   - - -
+
+***
+
+___
\ No newline at end of file
diff --git a/tests/fixtures/markdown/html_comment.html b/tests/fixtures/markdown/html_comment.html
new file mode 100644
index 000000000..009c3098e
--- /dev/null
+++ b/tests/fixtures/markdown/html_comment.html
@@ -0,0 +1,11 @@
+<!-- single line -->
+<p>paragraph</p>
+<!-- 
+  multiline -->
+<p>paragraph</p>
+<!-- sss -->abc
+<ul>
+<li>abcd</li>
+<li>bbbb</li>
+<li>cccc</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/html_comment.md b/tests/fixtures/markdown/html_comment.md
new file mode 100644
index 000000000..27aeb29b8
--- /dev/null
+++ b/tests/fixtures/markdown/html_comment.md
@@ -0,0 +1,14 @@
+<!-- single line -->
+
+paragraph
+
+<!-- 
+  multiline -->
+
+paragraph
+
+<!-- sss -->abc
+
+* abcd
+* bbbb
+* cccc
\ No newline at end of file
diff --git a/tests/fixtures/markdown/html_entity.html b/tests/fixtures/markdown/html_entity.html
new file mode 100644
index 000000000..13901d696
--- /dev/null
+++ b/tests/fixtures/markdown/html_entity.html
@@ -0,0 +1 @@
+<p>&amp; © {</p>
diff --git a/tests/fixtures/markdown/html_entity.md b/tests/fixtures/markdown/html_entity.md
new file mode 100644
index 000000000..ff545ea5c
--- /dev/null
+++ b/tests/fixtures/markdown/html_entity.md
@@ -0,0 +1 @@
+&amp; &copy; &#123;
\ No newline at end of file
diff --git a/tests/fixtures/markdown/image_reference.html b/tests/fixtures/markdown/image_reference.html
new file mode 100644
index 000000000..67fbd2c86
--- /dev/null
+++ b/tests/fixtures/markdown/image_reference.html
@@ -0,0 +1,2 @@
+<p><img src="/md.png" alt="Markdown Logo" /></p>
+<p>![missing reference]</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/image_reference.md b/tests/fixtures/markdown/image_reference.md
new file mode 100644
index 000000000..1e11d9479
--- /dev/null
+++ b/tests/fixtures/markdown/image_reference.md
@@ -0,0 +1,5 @@
+![Markdown Logo][image]
+
+[image]: /md.png
+
+![missing reference]
\ No newline at end of file
diff --git a/tests/fixtures/markdown/image_title.html b/tests/fixtures/markdown/image_title.html
new file mode 100644
index 000000000..c9de6d13f
--- /dev/null
+++ b/tests/fixtures/markdown/image_title.html
@@ -0,0 +1,2 @@
+<p><img src="/md.png" alt="alt" title="title" /></p>
+<p><img src="/md.png" alt="blank title" /></p>
diff --git a/tests/fixtures/markdown/image_title.md b/tests/fixtures/markdown/image_title.md
new file mode 100644
index 000000000..7ce2849a5
--- /dev/null
+++ b/tests/fixtures/markdown/image_title.md
@@ -0,0 +1,3 @@
+![alt](/md.png "title")
+
+![blank title](/md.png "")
\ No newline at end of file
diff --git a/tests/fixtures/markdown/implicit_reference.html b/tests/fixtures/markdown/implicit_reference.html
new file mode 100644
index 000000000..24b51c1b0
--- /dev/null
+++ b/tests/fixtures/markdown/implicit_reference.html
@@ -0,0 +1,4 @@
+<p>an <a href="http://example.com">implicit</a> reference link</p>
+<p>an <a href="http://example.com">implicit</a> reference link with an empty link definition</p>
+<p>an <a href="http://example.com">implicit</a> reference link followed by <a href="http://cnn.com">another</a></p>
+<p>an <a href="http://example.com" title="Example">explicit</a> reference link with a title</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/implicit_reference.md b/tests/fixtures/markdown/implicit_reference.md
new file mode 100644
index 000000000..f850df964
--- /dev/null
+++ b/tests/fixtures/markdown/implicit_reference.md
@@ -0,0 +1,13 @@
+an [implicit] reference link
+
+[implicit]: http://example.com
+
+an [implicit][] reference link with an empty link definition
+
+an [implicit][] reference link followed by [another][]
+
+[another]: http://cnn.com
+
+an [explicit][example] reference link with a title
+
+[example]: http://example.com "Example"
\ No newline at end of file
diff --git a/tests/fixtures/markdown/inline_link.html b/tests/fixtures/markdown/inline_link.html
new file mode 100644
index 000000000..99c85afc7
--- /dev/null
+++ b/tests/fixtures/markdown/inline_link.html
@@ -0,0 +1,7 @@
+<p><a href="http://example.com">link</a></p>
+<p><a href="/url-(parentheses)">link</a> with parentheses in URL</p>
+<p>(<a href="/index.php">link</a>) in parentheses</p>
+<p><a href="http://example.com"><code>link</code></a></p>
+<p><a href="http://example.com"><img src="http://parsedown.org/md.png" alt="MD Logo" /></a></p>
+<p><a href="http://example.com"><img src="http://parsedown.org/md.png" alt="MD Logo" /> and text</a></p>
+<p><a href="http://example.com"><img src="data:image/png;base64,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TUw6Y29tLmFkb2JlLnhtcAAAAAAAPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iWE1QIENvcmUgNS40LjAiPgogICA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPgogICAgICA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIgogICAgICAgICAgICB4bWxuczp0aWZmPSJodHRwOi8vbnMuYWRvYmUuY29tL3RpZmYvMS4wLyIKICAgICAgICAgICAgeG1sbnM6ZXhpZj0iaHR0cDovL25zLmFkb2JlLmNvbS9leGlmLzEuMC8iCiAgICAgICAgICAgIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIKICAgICAgICAgICAgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIj4KICAgICAgICAgPHRpZmY6UmVzb2x1dGlvblVuaXQ+MTwvdGlmZjpSZXNvbHV0aW9uVW5pdD4KICAgICAgICAgPHRpZmY6Q29tcHJlc3Npb24+NTwvdGlmZjpDb21wcmVzc2lvbj4KICAgICAgICAgPHRpZmY6WFJlc29sdXRpb24+NzI8L3RpZmY6WFJlc29sdXRpb24+CiAgICAgICAgIDx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+CiAgICAgICAgIDx0aWZmOllSZXNvbHV0aW9uPjcyPC90aWZmOllSZXNvbHV0aW9uPgogICAgICAgICA8ZXhpZjpQaXhlbFhEaW1lbnNpb24+MzI8L2V4aWY6UGl4ZWxYRGltZW5zaW9uPgogICAgICAgICA8ZXhpZjpDb2xvclNwYWNlPjE8L2V4aWY6Q29sb3JTcGFjZT4KICAgICAgICAgPGV4aWY6UGl4ZWxZRGltZW5zaW9uPjIwPC9leGlmOlBpeGVsWURpbWVuc2lvbj4KICAgICAgICAgPGRjOnN1YmplY3Q+CiAgICAgICAgICAgIDxyZGY6QmFnLz4KICAgICAgICAgPC9kYzpzdWJqZWN0PgogICAgICAgICA8eG1wOk1vZGlmeURhdGU+MjAxNS0wNi0xNFQxOTowNjo1OTwveG1wOk1vZGlmeURhdGU+CiAgICAgICAgIDx4bXA6Q3JlYXRvclRvb2w+UGl4ZWxtYXRvciAzLjI8L3htcDpDcmVhdG9yVG9vbD4KICAgICAgPC9yZGY6RGVzY3JpcHRpb24+CiAgIDwvcmRmOlJERj4KPC94OnhtcG1ldGE+Ch7v5WoAAAGgSURBVEgNYywtLbVnYmLqYmBgMANieoJT//79K2MBWr4CaKsEPW2G2mUGspsFZnlnZycjPR1RXl7+H2Q3Ez0txWbXgDsAFAUYABo8YPH////HdXV1LUZWVFZWFsvIyLgIJoYt+pDNwCYP00swBIAWzaysrNSCaQCxgWLTYHxKaawhgGYoJzC7rC4sLDQBiYPYQIoHTQ3ZXGIcADJci42NDeZreGiQbSuSRmKiABb/CUB9IMwAjAKYGIhLESAYAj9//kwH+t4YaAvM59c4ODiyvn//HotuMzDh9QLFirCIg/I8CPQBE2QxhAkhCYZAf3//d2CJFQpU/h2EQeyGhoYvyIbA2FDDl8H4aPQydMtB8gQdAFLU3t5+DRjsWSAMYoPEcAFOTs5EoNw+NPl9UHE0YQYGglEA09HR0bEAxsZHA0PnFzAqgoBq9gIxKOrOAnEQSBxIYwCiQgBDFwEBYFB/BEaVJ7AQ2wGiQXxcWhhhJRZQ0UBURsSlAVyup4Y4TaKAFIeBouAJUIM0KZqoqPYpEzBrpQANfEFFQ4k16gXIbgCggnKoJ5DJdwAAAABJRU5ErkJggg==" alt="MD Logo" /> and text</a></p>
diff --git a/tests/fixtures/markdown/inline_link.md b/tests/fixtures/markdown/inline_link.md
new file mode 100644
index 000000000..1ba24b76d
--- /dev/null
+++ b/tests/fixtures/markdown/inline_link.md
@@ -0,0 +1,13 @@
+[link](http://example.com)
+
+[link](/url-(parentheses)) with parentheses in URL 
+
+([link](/index.php)) in parentheses
+
+[`link`](http://example.com)
+
+[![MD Logo](http://parsedown.org/md.png)](http://example.com)
+
+[![MD Logo](http://parsedown.org/md.png) and text](http://example.com)
+
+[![MD Logo](data:image/png;base64,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TUw6Y29tLmFkb2JlLnhtcAAAAAAAPHg6eG1wbWV0YSB4bWxuczp4PSJhZG9iZTpuczptZXRhLyIgeDp4bXB0az0iWE1QIENvcmUgNS40LjAiPgogICA8cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPgogICAgICA8cmRmOkRlc2NyaXB0aW9uIHJkZjphYm91dD0iIgogICAgICAgICAgICB4bWxuczp0aWZmPSJodHRwOi8vbnMuYWRvYmUuY29tL3RpZmYvMS4wLyIKICAgICAgICAgICAgeG1sbnM6ZXhpZj0iaHR0cDovL25zLmFkb2JlLmNvbS9leGlmLzEuMC8iCiAgICAgICAgICAgIHhtbG5zOmRjPSJodHRwOi8vcHVybC5vcmcvZGMvZWxlbWVudHMvMS4xLyIKICAgICAgICAgICAgeG1sbnM6eG1wPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvIj4KICAgICAgICAgPHRpZmY6UmVzb2x1dGlvblVuaXQ+MTwvdGlmZjpSZXNvbHV0aW9uVW5pdD4KICAgICAgICAgPHRpZmY6Q29tcHJlc3Npb24+NTwvdGlmZjpDb21wcmVzc2lvbj4KICAgICAgICAgPHRpZmY6WFJlc29sdXRpb24+NzI8L3RpZmY6WFJlc29sdXRpb24+CiAgICAgICAgIDx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+CiAgICAgICAgIDx0aWZmOllSZXNvbHV0aW9uPjcyPC90aWZmOllSZXNvbHV0aW9uPgogICAgICAgICA8ZXhpZjpQaXhlbFhEaW1lbnNpb24+MzI8L2V4aWY6UGl4ZWxYRGltZW5zaW9uPgogICAgICAgICA8ZXhpZjpDb2xvclNwYWNlPjE8L2V4aWY6Q29sb3JTcGFjZT4KICAgICAgICAgPGV4aWY6UGl4ZWxZRGltZW5zaW9uPjIwPC9leGlmOlBpeGVsWURpbWVuc2lvbj4KICAgICAgICAgPGRjOnN1YmplY3Q+CiAgICAgICAgICAgIDxyZGY6QmFnLz4KICAgICAgICAgPC9kYzpzdWJqZWN0PgogICAgICAgICA8eG1wOk1vZGlmeURhdGU+MjAxNS0wNi0xNFQxOTowNjo1OTwveG1wOk1vZGlmeURhdGU+CiAgICAgICAgIDx4bXA6Q3JlYXRvclRvb2w+UGl4ZWxtYXRvciAzLjI8L3htcDpDcmVhdG9yVG9vbD4KICAgICAgPC9yZGY6RGVzY3JpcHRpb24+CiAgIDwvcmRmOlJERj4KPC94OnhtcG1ldGE+Ch7v5WoAAAGgSURBVEgNYywtLbVnYmLqYmBgMANieoJT//79K2MBWr4CaKsEPW2G2mUGspsFZnlnZycjPR1RXl7+H2Q3Ez0txWbXgDsAFAUYABo8YPH////HdXV1LUZWVFZWFsvIyLgIJoYt+pDNwCYP00swBIAWzaysrNSCaQCxgWLTYHxKaawhgGYoJzC7rC4sLDQBiYPYQIoHTQ3ZXGIcADJci42NDeZreGiQbSuSRmKiABb/CUB9IMwAjAKYGIhLESAYAj9//kwH+t4YaAvM59c4ODiyvn//HotuMzDh9QLFirCIg/I8CPQBE2QxhAkhCYZAf3//d2CJFQpU/h2EQeyGhoYvyIbA2FDDl8H4aPQydMtB8gQdAFLU3t5+DRjsWSAMYoPEcAFOTs5EoNw+NPl9UHE0YQYGglEA09HR0bEAxsZHA0PnFzAqgoBq9gIxKOrOAnEQSBxIYwCiQgBDFwEBYFB/BEaVJ7AQ2wGiQXxcWhhhJRZQ0UBURsSlAVyup4Y4TaKAFIeBouAJUIM0KZqoqPYpEzBrpQANfEFFQ4k16gXIbgCggnKoJ5DJdwAAAABJRU5ErkJggg==) and text](http://example.com)
\ No newline at end of file
diff --git a/tests/fixtures/markdown/inline_link_title.html b/tests/fixtures/markdown/inline_link_title.html
new file mode 100644
index 000000000..479098edf
--- /dev/null
+++ b/tests/fixtures/markdown/inline_link_title.html
@@ -0,0 +1,6 @@
+<p><a href="http://example.com" title="Title">single quotes</a></p>
+<p><a href="http://example.com" title="Title">double quotes</a></p>
+<p><a href="http://example.com">single quotes blank</a></p>
+<p><a href="http://example.com">double quotes blank</a></p>
+<p><a href="http://example.com" title="2 Words">space</a></p>
+<p><a href="http://example.com/url-(parentheses)" title="Title">parentheses</a></p>
diff --git a/tests/fixtures/markdown/inline_link_title.md b/tests/fixtures/markdown/inline_link_title.md
new file mode 100644
index 000000000..6e1c5af9b
--- /dev/null
+++ b/tests/fixtures/markdown/inline_link_title.md
@@ -0,0 +1,11 @@
+[single quotes](http://example.com 'Title')
+
+[double quotes](http://example.com "Title")
+
+[single quotes blank](http://example.com '')
+
+[double quotes blank](http://example.com "")
+
+[space](http://example.com "2 Words")
+
+[parentheses](http://example.com/url-(parentheses) "Title")
\ No newline at end of file
diff --git a/tests/fixtures/markdown/inline_title.html b/tests/fixtures/markdown/inline_title.html
new file mode 100644
index 000000000..bbab93b6c
--- /dev/null
+++ b/tests/fixtures/markdown/inline_title.html
@@ -0,0 +1 @@
+<p><a href="http://example.com" title="Example">single quotes</a> and <a href="http://example.com" title="Example">double quotes</a></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/inline_title.md b/tests/fixtures/markdown/inline_title.md
new file mode 100644
index 000000000..cb09344a1
--- /dev/null
+++ b/tests/fixtures/markdown/inline_title.md
@@ -0,0 +1 @@
+[single quotes](http://example.com 'Example') and [double quotes](http://example.com "Example")
\ No newline at end of file
diff --git a/tests/fixtures/markdown/lazy_blockquote.html b/tests/fixtures/markdown/lazy_blockquote.html
new file mode 100644
index 000000000..dea3dca32
--- /dev/null
+++ b/tests/fixtures/markdown/lazy_blockquote.html
@@ -0,0 +1,8 @@
+<blockquote>
+<p>quote
+the rest of it</p>
+</blockquote>
+<blockquote>
+<p>another paragraph
+the rest of it</p>
+</blockquote>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/lazy_blockquote.md b/tests/fixtures/markdown/lazy_blockquote.md
new file mode 100644
index 000000000..48f645f94
--- /dev/null
+++ b/tests/fixtures/markdown/lazy_blockquote.md
@@ -0,0 +1,5 @@
+> quote
+the rest of it
+
+> another paragraph
+the rest of it
\ No newline at end of file
diff --git a/tests/fixtures/markdown/lazy_list.html b/tests/fixtures/markdown/lazy_list.html
new file mode 100644
index 000000000..1a5199249
--- /dev/null
+++ b/tests/fixtures/markdown/lazy_list.html
@@ -0,0 +1,4 @@
+<ul>
+<li>li
+the rest of it</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/lazy_list.md b/tests/fixtures/markdown/lazy_list.md
new file mode 100644
index 000000000..62ad9d719
--- /dev/null
+++ b/tests/fixtures/markdown/lazy_list.md
@@ -0,0 +1,2 @@
+- li
+the rest of it
\ No newline at end of file
diff --git a/tests/fixtures/markdown/line_break.html b/tests/fixtures/markdown/line_break.html
new file mode 100644
index 000000000..5f37d854c
--- /dev/null
+++ b/tests/fixtures/markdown/line_break.html
@@ -0,0 +1,2 @@
+<p>line<br />
+line</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/line_break.md b/tests/fixtures/markdown/line_break.md
new file mode 100644
index 000000000..04dff43e0
--- /dev/null
+++ b/tests/fixtures/markdown/line_break.md
@@ -0,0 +1,2 @@
+line  
+line
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_one.html b/tests/fixtures/markdown/markup_consecutive_one.html
new file mode 100644
index 000000000..d4c500541
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_one.html
@@ -0,0 +1,3 @@
+<div>Markup</div>
+_No markdown_ without blank line for **strict** compliance with CommonMark.
+<p><strong>Markdown</strong></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_one.md b/tests/fixtures/markdown/markup_consecutive_one.md
new file mode 100644
index 000000000..18b4dcb8a
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_one.md
@@ -0,0 +1,4 @@
+<div>Markup</div>
+_No markdown_ without blank line for **strict** compliance with CommonMark.
+
+**Markdown**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_one_line.html b/tests/fixtures/markdown/markup_consecutive_one_line.html
new file mode 100644
index 000000000..a89b4fd32
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_one_line.html
@@ -0,0 +1,4 @@
+<div>One markup on
+two lines</div>
+_No markdown_
+<p><strong>Markdown</strong></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_one_line.md b/tests/fixtures/markdown/markup_consecutive_one_line.md
new file mode 100644
index 000000000..daf945a1e
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_one_line.md
@@ -0,0 +1,5 @@
+<div>One markup on
+two lines</div>
+_No markdown_
+
+**Markdown**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_one_stripped.html b/tests/fixtures/markdown/markup_consecutive_one_stripped.html
new file mode 100644
index 000000000..ccc01f185
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_one_stripped.html
@@ -0,0 +1,3 @@
+<div><p>Stripped markup</p></div>
+_No markdown_
+<p><strong>Markdown</strong></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_one_stripped.md b/tests/fixtures/markdown/markup_consecutive_one_stripped.md
new file mode 100644
index 000000000..7f8df0c1b
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_one_stripped.md
@@ -0,0 +1,4 @@
+<div><p>Stripped markup</p></div>
+_No markdown_
+
+**Markdown**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_two.html b/tests/fixtures/markdown/markup_consecutive_two.html
new file mode 100644
index 000000000..f7e71c7c1
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_two.html
@@ -0,0 +1,3 @@
+<div>First markup</div><p>and second markup on the same line.</p>
+_No markdown_
+<p><strong>Markdown</strong></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_two.md b/tests/fixtures/markdown/markup_consecutive_two.md
new file mode 100644
index 000000000..83f3af771
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_two.md
@@ -0,0 +1,4 @@
+<div>First markup</div><p>and second markup on the same line.</p>
+_No markdown_
+
+**Markdown**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_two_lines.html b/tests/fixtures/markdown/markup_consecutive_two_lines.html
new file mode 100644
index 000000000..ffa4728c9
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_two_lines.html
@@ -0,0 +1,4 @@
+<div>First markup</div><p>and partial markup
+on two lines.</p>
+_No markdown_
+<p><strong>Markdown</strong></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_two_lines.md b/tests/fixtures/markdown/markup_consecutive_two_lines.md
new file mode 100644
index 000000000..dc70bb760
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_two_lines.md
@@ -0,0 +1,5 @@
+<div>First markup</div><p>and partial markup
+on two lines.</p>
+_No markdown_
+
+**Markdown**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_two_stripped.html b/tests/fixtures/markdown/markup_consecutive_two_stripped.html
new file mode 100644
index 000000000..707d6be93
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_two_stripped.html
@@ -0,0 +1,4 @@
+<div><p>Stripped markup
+on two lines</p></div>
+_No markdown_
+<p><strong>Markdown</strong></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/markup_consecutive_two_stripped.md b/tests/fixtures/markdown/markup_consecutive_two_stripped.md
new file mode 100644
index 000000000..af5b7812a
--- /dev/null
+++ b/tests/fixtures/markdown/markup_consecutive_two_stripped.md
@@ -0,0 +1,5 @@
+<div><p>Stripped markup
+on two lines</p></div>
+_No markdown_
+
+**Markdown**
\ No newline at end of file
diff --git a/tests/fixtures/markdown/multiline_list_paragraph.html b/tests/fixtures/markdown/multiline_list_paragraph.html
new file mode 100644
index 000000000..3247bd227
--- /dev/null
+++ b/tests/fixtures/markdown/multiline_list_paragraph.html
@@ -0,0 +1,7 @@
+<ul>
+<li>
+<p>li</p>
+<p>line
+line</p>
+</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/multiline_list_paragraph.md b/tests/fixtures/markdown/multiline_list_paragraph.md
new file mode 100644
index 000000000..f5b42729f
--- /dev/null
+++ b/tests/fixtures/markdown/multiline_list_paragraph.md
@@ -0,0 +1,4 @@
+- li
+
+  line
+  line
\ No newline at end of file
diff --git a/tests/fixtures/markdown/multiline_lists.html b/tests/fixtures/markdown/multiline_lists.html
new file mode 100644
index 000000000..a223792e9
--- /dev/null
+++ b/tests/fixtures/markdown/multiline_lists.html
@@ -0,0 +1,10 @@
+<ol>
+<li>
+<p>One
+First body copy</p>
+</li>
+<li>
+<p>Two
+Last body copy</p>
+</li>
+</ol>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/multiline_lists.md b/tests/fixtures/markdown/multiline_lists.md
new file mode 100644
index 000000000..6251115fe
--- /dev/null
+++ b/tests/fixtures/markdown/multiline_lists.md
@@ -0,0 +1,5 @@
+1. One
+   First body copy
+
+2. Two
+   Last body copy
diff --git a/tests/fixtures/markdown/nested_block-level_html.html b/tests/fixtures/markdown/nested_block-level_html.html
new file mode 100644
index 000000000..bfbef54d7
--- /dev/null
+++ b/tests/fixtures/markdown/nested_block-level_html.html
@@ -0,0 +1,10 @@
+<div>
+_parent_
+<div>
+_child_
+</div>
+<pre>
+_adopted child_
+</pre>
+</div>
+<p><em>outside</em></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/nested_block-level_html.md b/tests/fixtures/markdown/nested_block-level_html.md
new file mode 100644
index 000000000..5e01e1097
--- /dev/null
+++ b/tests/fixtures/markdown/nested_block-level_html.md
@@ -0,0 +1,11 @@
+<div>
+_parent_
+<div>
+_child_
+</div>
+<pre>
+_adopted child_
+</pre>
+</div>
+
+_outside_
\ No newline at end of file
diff --git a/tests/fixtures/markdown/ordered_list.html b/tests/fixtures/markdown/ordered_list.html
new file mode 100644
index 000000000..677b19d80
--- /dev/null
+++ b/tests/fixtures/markdown/ordered_list.html
@@ -0,0 +1,16 @@
+<ol>
+<li>one</li>
+<li>two</li>
+</ol>
+<p>repeating numbers:</p>
+<ol>
+<li>one</li>
+<li>two</li>
+</ol>
+<p>large numbers:</p>
+<ol start="123">
+<li>one</li>
+</ol>
+<p>foo 1. the following should not start a list
+100.<br />
+200.</p>
diff --git a/tests/fixtures/markdown/ordered_list.md b/tests/fixtures/markdown/ordered_list.md
new file mode 100644
index 000000000..d7e7fc1c9
--- /dev/null
+++ b/tests/fixtures/markdown/ordered_list.md
@@ -0,0 +1,15 @@
+1. one
+2. two
+
+repeating numbers:
+
+1. one
+1. two
+
+large numbers:
+
+123. one
+
+foo 1. the following should not start a list
+100.  
+200. 
\ No newline at end of file
diff --git a/tests/fixtures/markdown/paragraph_list.html b/tests/fixtures/markdown/paragraph_list.html
new file mode 100644
index 000000000..00a612c13
--- /dev/null
+++ b/tests/fixtures/markdown/paragraph_list.html
@@ -0,0 +1,14 @@
+<p>paragraph</p>
+<ul>
+<li>li</li>
+<li>li</li>
+</ul>
+<p>paragraph</p>
+<ul>
+<li>
+<p>li</p>
+</li>
+<li>
+<p>li</p>
+</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/paragraph_list.md b/tests/fixtures/markdown/paragraph_list.md
new file mode 100644
index 000000000..b973908ce
--- /dev/null
+++ b/tests/fixtures/markdown/paragraph_list.md
@@ -0,0 +1,9 @@
+paragraph
+- li
+- li
+
+paragraph
+
+   * li
+   
+   * li
\ No newline at end of file
diff --git a/tests/fixtures/markdown/reference_title.html b/tests/fixtures/markdown/reference_title.html
new file mode 100644
index 000000000..8f2be944c
--- /dev/null
+++ b/tests/fixtures/markdown/reference_title.html
@@ -0,0 +1,2 @@
+<p><a href="http://example.com" title="example title">double quotes</a> and <a href="http://example.com" title="example title">single quotes</a> and <a href="http://example.com" title="example title">parentheses</a></p>
+<p>[invalid title]: <a href="http://example.com">http://example.com</a> example title</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/reference_title.md b/tests/fixtures/markdown/reference_title.md
new file mode 100644
index 000000000..43cb21708
--- /dev/null
+++ b/tests/fixtures/markdown/reference_title.md
@@ -0,0 +1,6 @@
+[double quotes] and [single quotes] and [parentheses]
+
+[double quotes]: http://example.com "example title"
+[single quotes]: http://example.com 'example title'
+[parentheses]: http://example.com (example title)
+[invalid title]: http://example.com example title
\ No newline at end of file
diff --git a/tests/fixtures/markdown/self-closing_html.html b/tests/fixtures/markdown/self-closing_html.html
new file mode 100644
index 000000000..4d072b43f
--- /dev/null
+++ b/tests/fixtures/markdown/self-closing_html.html
@@ -0,0 +1,12 @@
+<hr>
+<p>paragraph</p>
+<hr/>
+<p>paragraph</p>
+<hr />
+<p>paragraph</p>
+<hr class="foo" id="bar" />
+<p>paragraph</p>
+<hr class="foo" id="bar"/>
+<p>paragraph</p>
+<hr class="foo" id="bar" >
+<p>paragraph</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/self-closing_html.md b/tests/fixtures/markdown/self-closing_html.md
new file mode 100644
index 000000000..61d16a39b
--- /dev/null
+++ b/tests/fixtures/markdown/self-closing_html.md
@@ -0,0 +1,18 @@
+<hr>
+
+paragraph
+<hr/>
+
+paragraph
+<hr />
+
+paragraph
+<hr class="foo" id="bar" />
+
+paragraph
+<hr class="foo" id="bar"/>
+
+paragraph
+<hr class="foo" id="bar" >
+
+paragraph
\ No newline at end of file
diff --git a/tests/fixtures/markdown/separated_nested_list.html b/tests/fixtures/markdown/separated_nested_list.html
new file mode 100644
index 000000000..80a5cae26
--- /dev/null
+++ b/tests/fixtures/markdown/separated_nested_list.html
@@ -0,0 +1,9 @@
+<ul>
+<li>
+<p>li</p>
+<ul>
+<li>li</li>
+<li>li</li>
+</ul>
+</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/separated_nested_list.md b/tests/fixtures/markdown/separated_nested_list.md
new file mode 100644
index 000000000..d7cd1af79
--- /dev/null
+++ b/tests/fixtures/markdown/separated_nested_list.md
@@ -0,0 +1,4 @@
+- li
+
+    - li
+    - li
\ No newline at end of file
diff --git a/tests/fixtures/markdown/setext_header.html b/tests/fixtures/markdown/setext_header.html
new file mode 100644
index 000000000..60aac0815
--- /dev/null
+++ b/tests/fixtures/markdown/setext_header.html
@@ -0,0 +1,5 @@
+<h1>h1</h1>
+<h2>h2</h2>
+<h2>single character</h2>
+<p>not a header</p>
+<hr />
\ No newline at end of file
diff --git a/tests/fixtures/markdown/setext_header.md b/tests/fixtures/markdown/setext_header.md
new file mode 100644
index 000000000..c43b52c36
--- /dev/null
+++ b/tests/fixtures/markdown/setext_header.md
@@ -0,0 +1,12 @@
+h1
+==
+
+h2
+--
+
+single character
+-
+
+not a header
+
+------------
\ No newline at end of file
diff --git a/tests/fixtures/markdown/setext_header_spaces.html b/tests/fixtures/markdown/setext_header_spaces.html
new file mode 100644
index 000000000..daf97c0da
--- /dev/null
+++ b/tests/fixtures/markdown/setext_header_spaces.html
@@ -0,0 +1,12 @@
+<h1>trailing space</h1>
+<h2>trailing space</h2>
+<h1>leading and trailing space</h1>
+<h2>leading and trailing space</h2>
+<h1>1 leading space</h1>
+<h2>1 leading space</h2>
+<h1>3 leading spaces</h1>
+<h2>3 leading spaces</h2>
+<p>too many leading spaces
+==</p>
+<p>too many leading spaces
+--</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/setext_header_spaces.md b/tests/fixtures/markdown/setext_header_spaces.md
new file mode 100644
index 000000000..4ac35bb74
--- /dev/null
+++ b/tests/fixtures/markdown/setext_header_spaces.md
@@ -0,0 +1,29 @@
+trailing space
+== 
+
+trailing space
+-- 
+
+leading and trailing space
+ == 
+
+leading and trailing space
+ -- 
+
+1 leading space
+ ==
+
+1 leading space
+ --
+
+3 leading spaces
+   ==
+
+3 leading spaces
+   --
+
+too many leading spaces
+    ==
+
+too many leading spaces
+    --
\ No newline at end of file
diff --git a/tests/fixtures/markdown/simple_blockquote.html b/tests/fixtures/markdown/simple_blockquote.html
new file mode 100644
index 000000000..9f9bfabaf
--- /dev/null
+++ b/tests/fixtures/markdown/simple_blockquote.html
@@ -0,0 +1,26 @@
+<blockquote>
+<p>quote</p>
+</blockquote>
+<p>indented:</p>
+<blockquote>
+<p>quote</p>
+</blockquote>
+<p>no space after <code>&gt;</code>:</p>
+<blockquote>
+<p>quote</p>
+</blockquote>
+<hr />
+<blockquote>
+<blockquote>
+<blockquote>
+<p>Info 1 text</p>
+</blockquote>
+</blockquote>
+</blockquote>
+<blockquote>
+<blockquote>
+<blockquote>
+<p>Info 2 text</p>
+</blockquote>
+</blockquote>
+</blockquote>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/simple_blockquote.md b/tests/fixtures/markdown/simple_blockquote.md
new file mode 100644
index 000000000..d7c3e12bc
--- /dev/null
+++ b/tests/fixtures/markdown/simple_blockquote.md
@@ -0,0 +1,13 @@
+> quote
+
+indented:
+   > quote
+
+no space after `>`:
+>quote
+
+---
+
+>>> Info 1 text
+
+>>> Info 2 text
\ No newline at end of file
diff --git a/tests/fixtures/markdown/simple_table.html b/tests/fixtures/markdown/simple_table.html
new file mode 100644
index 000000000..c42ff60aa
--- /dev/null
+++ b/tests/fixtures/markdown/simple_table.html
@@ -0,0 +1,83 @@
+<table>
+<thead>
+<tr>
+<th>header 1</th>
+<th>header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>cell 1.1</td>
+<td>cell 1.2</td>
+</tr>
+<tr>
+<td>cell 2.1</td>
+<td>cell 2.2</td>
+</tr>
+</tbody>
+</table>
+<hr />
+<p>mismatched 1 | mismatched 2 | mismatched 3
+-------- | --------
+cell 1.1 | cell 1.2
+cell 2.1 | cell 2.2</p>
+<hr />
+<table>
+<thead>
+<tr>
+<th align="left">header 1</th>
+<th>header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td align="left">cell 1.1</td>
+<td>cell 1.2</td>
+</tr>
+<tr>
+<td align="left">cell 2.1</td>
+<td>cell 2.2</td>
+</tr>
+</tbody>
+</table>
+<hr />
+<p>Not a table.header 1:-------cell 1.1cell 2.1</p>
+<hr />
+<p>Not a table.header 1-------|cell 1.1cell 2.1</p>
+<hr />
+<p>Is a table.</p>
+<table>
+<thead>
+<tr>
+<th>header 1</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>cell 1.1</td>
+</tr>
+<tr>
+<td>cell 2.1</td>
+</tr>
+</tbody>
+</table>
+<hr />
+<p>Tables can immediately follow a paragraph.</p>
+<table>
+<thead>
+<tr>
+<th>header 1</th>
+<th>header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>cell 1.1</td>
+<td>cell 1.2</td>
+</tr>
+<tr>
+<td>cell 2.1</td>
+<td>cell 2.2</td>
+</tr>
+</tbody>
+</table>
diff --git a/tests/fixtures/markdown/simple_table.md b/tests/fixtures/markdown/simple_table.md
new file mode 100644
index 000000000..d6c3246b9
--- /dev/null
+++ b/tests/fixtures/markdown/simple_table.md
@@ -0,0 +1,50 @@
+header 1 | header 2
+-------- | --------
+cell 1.1 | cell 1.2
+cell 2.1 | cell 2.2
+
+---
+
+mismatched 1 | mismatched 2 | mismatched 3
+-------- | --------
+cell 1.1 | cell 1.2
+cell 2.1 | cell 2.2
+
+---
+
+header 1 | header 2
+:------- | --------
+cell 1.1 | cell 1.2
+cell 2.1 | cell 2.2
+
+---
+
+Not a table.
+header 1
+:-------
+cell 1.1
+cell 2.1
+
+---
+
+Not a table.
+header 1
+-------|
+cell 1.1
+cell 2.1
+
+---
+
+Is a table.
+| header 1 |
+| -------- |
+| cell 1.1 |
+| cell 2.1 |
+
+---
+
+Tables can immediately follow a paragraph.
+header 1 | header 2
+-------- | --------
+cell 1.1 | cell 1.2
+cell 2.1 | cell 2.2
diff --git a/tests/fixtures/markdown/span-level_html.html b/tests/fixtures/markdown/span-level_html.html
new file mode 100644
index 000000000..072e00262
--- /dev/null
+++ b/tests/fixtures/markdown/span-level_html.html
@@ -0,0 +1,6 @@
+<p>an <b>important</b> <a href=''>link</a></p>
+<p>broken<br/>
+line</p>
+<p><b>inline tag</b> at the beginning</p>
+<p><span>http://example.com</span></p>
+<p><span><a href="http://example.com">http://example.com</a></span></p>
diff --git a/tests/fixtures/markdown/span-level_html.md b/tests/fixtures/markdown/span-level_html.md
new file mode 100644
index 000000000..0ceb5a996
--- /dev/null
+++ b/tests/fixtures/markdown/span-level_html.md
@@ -0,0 +1,10 @@
+an <b>important</b> <a href=''>link</a>
+
+broken<br/>
+line
+
+<b>inline tag</b> at the beginning
+
+<span>http://example.com</span>
+
+<span><http://example.com></span>
diff --git a/tests/fixtures/markdown/sparse_dense_list.html b/tests/fixtures/markdown/sparse_dense_list.html
new file mode 100644
index 000000000..58923f8a1
--- /dev/null
+++ b/tests/fixtures/markdown/sparse_dense_list.html
@@ -0,0 +1,11 @@
+<ul>
+<li>
+<p>li</p>
+</li>
+<li>
+<p>li</p>
+</li>
+<li>
+<p>li</p>
+</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/sparse_dense_list.md b/tests/fixtures/markdown/sparse_dense_list.md
new file mode 100644
index 000000000..576842277
--- /dev/null
+++ b/tests/fixtures/markdown/sparse_dense_list.md
@@ -0,0 +1,4 @@
+- li
+
+- li
+- li
\ No newline at end of file
diff --git a/tests/fixtures/markdown/sparse_html.html b/tests/fixtures/markdown/sparse_html.html
new file mode 100644
index 000000000..6e0213fab
--- /dev/null
+++ b/tests/fixtures/markdown/sparse_html.html
@@ -0,0 +1,6 @@
+<div>
+line 1
+<p>line 2
+line 3</p>
+<p>line 4</p>
+</div>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/sparse_html.md b/tests/fixtures/markdown/sparse_html.md
new file mode 100644
index 000000000..9e896274c
--- /dev/null
+++ b/tests/fixtures/markdown/sparse_html.md
@@ -0,0 +1,8 @@
+<div>
+line 1
+
+line 2
+line 3
+
+line 4
+</div>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/sparse_list.html b/tests/fixtures/markdown/sparse_list.html
new file mode 100644
index 000000000..9803d27cd
--- /dev/null
+++ b/tests/fixtures/markdown/sparse_list.html
@@ -0,0 +1,17 @@
+<ul>
+<li>
+<p>li</p>
+</li>
+<li>
+<p>li</p>
+</li>
+</ul>
+<hr />
+<ul>
+<li>
+<p>li</p>
+<ul>
+<li>indented li</li>
+</ul>
+</li>
+</ul>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/sparse_list.md b/tests/fixtures/markdown/sparse_list.md
new file mode 100644
index 000000000..362a35f57
--- /dev/null
+++ b/tests/fixtures/markdown/sparse_list.md
@@ -0,0 +1,9 @@
+- li
+
+- li
+
+---
+
+- li
+
+    - indented li
\ No newline at end of file
diff --git a/tests/fixtures/markdown/special_characters.html b/tests/fixtures/markdown/special_characters.html
new file mode 100644
index 000000000..3b652c338
--- /dev/null
+++ b/tests/fixtures/markdown/special_characters.html
@@ -0,0 +1,6 @@
+<p>AT&amp;T has an ampersand in their name</p>
+<p>this &amp; that</p>
+<p>4 &lt; 5 and 6 &gt; 5</p>
+<p><a href="http://example.com/autolink?a=1&amp;b=2">http://example.com/autolink?a=1&amp;b=2</a></p>
+<p><a href="/script?a=1&amp;b=2">inline link</a></p>
+<p><a href="http://example.com/?a=1&amp;b=2">reference link</a></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/special_characters.md b/tests/fixtures/markdown/special_characters.md
new file mode 100644
index 000000000..111b03b63
--- /dev/null
+++ b/tests/fixtures/markdown/special_characters.md
@@ -0,0 +1,13 @@
+AT&T has an ampersand in their name
+
+this & that
+
+4 < 5 and 6 > 5
+
+<http://example.com/autolink?a=1&b=2>
+
+[inline link](/script?a=1&b=2)
+
+[reference link][1]
+
+[1]: http://example.com/?a=1&b=2
\ No newline at end of file
diff --git a/tests/fixtures/markdown/strikethrough.html b/tests/fixtures/markdown/strikethrough.html
new file mode 100644
index 000000000..14bb5a297
--- /dev/null
+++ b/tests/fixtures/markdown/strikethrough.html
@@ -0,0 +1,4 @@
+<p><del>strikethrough</del></p>
+<p>here's <del>one</del> followed by <del>another one</del></p>
+<p>~~ this ~~ is not one neither is ~this~</p>
+<p>escaped ~~this~~</p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/strikethrough.md b/tests/fixtures/markdown/strikethrough.md
new file mode 100644
index 000000000..83d5b35ef
--- /dev/null
+++ b/tests/fixtures/markdown/strikethrough.md
@@ -0,0 +1,7 @@
+~~strikethrough~~
+
+here's ~~one~~ followed by ~~another one~~
+
+~~ this ~~ is not one neither is ~this~
+
+escaped \~\~this\~\~
\ No newline at end of file
diff --git a/tests/fixtures/markdown/strong_em.html b/tests/fixtures/markdown/strong_em.html
new file mode 100644
index 000000000..b709c9914
--- /dev/null
+++ b/tests/fixtures/markdown/strong_em.html
@@ -0,0 +1,6 @@
+<p><em>em <strong>strong em</strong></em></p>
+<p><em><strong>strong em</strong> em</em></p>
+<p><em>em <strong>strong em</strong> em</em></p>
+<p><em>em <strong>strong em</strong></em></p>
+<p><em><strong>strong em</strong> em</em></p>
+<p><em>em <strong>strong em</strong> em</em></p>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/strong_em.md b/tests/fixtures/markdown/strong_em.md
new file mode 100644
index 000000000..f2aa3c782
--- /dev/null
+++ b/tests/fixtures/markdown/strong_em.md
@@ -0,0 +1,11 @@
+*em **strong em***
+
+***strong em** em*
+
+*em **strong em** em*
+
+_em __strong em___
+
+___strong em__ em_
+
+_em __strong em__ em_
\ No newline at end of file
diff --git a/tests/fixtures/markdown/tab-indented_code_block.html b/tests/fixtures/markdown/tab-indented_code_block.html
new file mode 100644
index 000000000..e636f26e5
--- /dev/null
+++ b/tests/fixtures/markdown/tab-indented_code_block.html
@@ -0,0 +1,6 @@
+<pre><code>&lt;?php
+
+$message = 'Hello World!';
+echo $message;
+
+echo &quot;following a blank line&quot;;</code></pre>
diff --git a/tests/fixtures/markdown/tab-indented_code_block.md b/tests/fixtures/markdown/tab-indented_code_block.md
new file mode 100644
index 000000000..a405a1609
--- /dev/null
+++ b/tests/fixtures/markdown/tab-indented_code_block.md
@@ -0,0 +1,6 @@
+	<?php
+	
+	$message = 'Hello World!';
+	echo $message;
+
+	echo "following a blank line";
\ No newline at end of file
diff --git a/tests/fixtures/markdown/table_inline_markdown.html b/tests/fixtures/markdown/table_inline_markdown.html
new file mode 100644
index 000000000..5741858ba
--- /dev/null
+++ b/tests/fixtures/markdown/table_inline_markdown.html
@@ -0,0 +1,26 @@
+<table>
+<thead>
+<tr>
+<th><em>header</em> 1</th>
+<th>header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><em>cell</em> 1.1</td>
+<td><del>cell</del> 1.2</td>
+</tr>
+<tr>
+<td>`</td>
+<td>` broken</td>
+</tr>
+<tr>
+<td><code>|</code> 2.1</td>
+<td>| 2.2</td>
+</tr>
+<tr>
+<td><code>\|</code> 2.1</td>
+<td><a href="/">link</a></td>
+</tr>
+</tbody>
+</table>
diff --git a/tests/fixtures/markdown/table_inline_markdown.md b/tests/fixtures/markdown/table_inline_markdown.md
new file mode 100644
index 000000000..2bd1b66ea
--- /dev/null
+++ b/tests/fixtures/markdown/table_inline_markdown.md
@@ -0,0 +1,6 @@
+| _header_ 1   | header 2     |
+| ------------ | ------------ |
+| _cell_ 1.1   | ~~cell~~ 1.2 |
+| `|` broken   | \| 2.2       |
+| `\|` 2.1     | \| 2.2       |
+| `\\|` 2.1    | [link](/)    |
diff --git a/tests/fixtures/markdown/text_reference.html b/tests/fixtures/markdown/text_reference.html
new file mode 100644
index 000000000..6200c973f
--- /dev/null
+++ b/tests/fixtures/markdown/text_reference.html
@@ -0,0 +1,8 @@
+<p><a href="http://example.com">reference link</a></p>
+<p><a href="http://example.com">one</a> with a semantic name</p>
+<p>[one][404] with no definition</p>
+<p><a href="http://example.com">multiline
+one</a> defined on 2 lines</p>
+<p><a href="http://example.com">one</a> with a mixed case label and an upper case definition</p>
+<p>[one]<a href="http://example.com">1</a> with the a label on the next line</p>
+<p><a href="http://example.com"><code>link</code></a></p>
diff --git a/tests/fixtures/markdown/text_reference.md b/tests/fixtures/markdown/text_reference.md
new file mode 100644
index 000000000..1a66a5cf6
--- /dev/null
+++ b/tests/fixtures/markdown/text_reference.md
@@ -0,0 +1,21 @@
+[reference link][1]
+
+[1]: http://example.com
+
+[one][website] with a semantic name
+
+[website]: http://example.com
+
+[one][404] with no definition
+
+[multiline
+one][website] defined on 2 lines
+
+[one][Label] with a mixed case label and an upper case definition
+
+[LABEL]: http://example.com
+
+[one]
+[1] with the a label on the next line
+
+[`link`][website]
\ No newline at end of file
diff --git a/tests/fixtures/markdown/unordered_list.html b/tests/fixtures/markdown/unordered_list.html
new file mode 100644
index 000000000..6ed70a690
--- /dev/null
+++ b/tests/fixtures/markdown/unordered_list.html
@@ -0,0 +1,22 @@
+<ul>
+<li>li</li>
+<li>li</li>
+</ul>
+<p>mixed unordered markers:</p>
+<ul>
+<li>li</li>
+</ul>
+<ul>
+<li>li</li>
+</ul>
+<ul>
+<li>li</li>
+</ul>
+<p>mixed ordered markers:</p>
+<ol>
+<li>starting at 1, list one</li>
+<li>number 2, list one</li>
+</ol>
+<ol start="3">
+<li>starting at 3, list two</li>
+</ol>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/unordered_list.md b/tests/fixtures/markdown/unordered_list.md
new file mode 100644
index 000000000..c1b8640cf
--- /dev/null
+++ b/tests/fixtures/markdown/unordered_list.md
@@ -0,0 +1,14 @@
+- li
+- li
+
+mixed unordered markers:
+
+* li
++ li
+- li
+
+mixed ordered markers:
+
+1. starting at 1, list one
+2. number 2, list one
+3) starting at 3, list two
\ No newline at end of file
diff --git a/tests/fixtures/markdown/untidy_table.html b/tests/fixtures/markdown/untidy_table.html
new file mode 100644
index 000000000..88e1c2bd4
--- /dev/null
+++ b/tests/fixtures/markdown/untidy_table.html
@@ -0,0 +1,18 @@
+<table>
+<thead>
+<tr>
+<th>header 1</th>
+<th>header 2</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>cell 1.1</td>
+<td>cell 1.2</td>
+</tr>
+<tr>
+<td>cell 2.1</td>
+<td>cell 2.2</td>
+</tr>
+</tbody>
+</table>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/untidy_table.md b/tests/fixtures/markdown/untidy_table.md
new file mode 100644
index 000000000..8524eb184
--- /dev/null
+++ b/tests/fixtures/markdown/untidy_table.md
@@ -0,0 +1,4 @@
+| header 1 | header 2          |
+| ------------- | ----------- |
+| cell 1.1   | cell 1.2 |
+|    cell 2.1 | cell 2.2     |
\ No newline at end of file
diff --git a/tests/fixtures/markdown/url_autolinking.html b/tests/fixtures/markdown/url_autolinking.html
new file mode 100644
index 000000000..37911e2d2
--- /dev/null
+++ b/tests/fixtures/markdown/url_autolinking.html
@@ -0,0 +1,3 @@
+<p>an autolink <a href="http://example.com">http://example.com</a></p>
+<p>inside of brackets [http://example.com], inside of braces {http://example.com},  inside of parentheses (<a href="http://example.com">http://example.com</a>)</p>
+<p>trailing slash <a href="http://example.com/">http://example.com/</a> and <a href="http://example.com/path/">http://example.com/path/</a></p>
diff --git a/tests/fixtures/markdown/url_autolinking.md b/tests/fixtures/markdown/url_autolinking.md
new file mode 100644
index 000000000..840f35404
--- /dev/null
+++ b/tests/fixtures/markdown/url_autolinking.md
@@ -0,0 +1,5 @@
+an autolink http://example.com
+
+inside of brackets [http://example.com], inside of braces {http://example.com},  inside of parentheses (http://example.com)
+
+trailing slash http://example.com/ and http://example.com/path/
\ No newline at end of file
diff --git a/tests/fixtures/markdown/whitespace.html b/tests/fixtures/markdown/whitespace.html
new file mode 100644
index 000000000..f2dd7a002
--- /dev/null
+++ b/tests/fixtures/markdown/whitespace.html
@@ -0,0 +1 @@
+<pre><code>code</code></pre>
\ No newline at end of file
diff --git a/tests/fixtures/markdown/whitespace.md b/tests/fixtures/markdown/whitespace.md
new file mode 100644
index 000000000..4cf926a8a
--- /dev/null
+++ b/tests/fixtures/markdown/whitespace.md
@@ -0,0 +1,5 @@
+    
+
+    code
+
+    
\ No newline at end of file

From f67f320c3938c12c3ae0d120e256fccc5dca2baa Mon Sep 17 00:00:00 2001
From: Ben Thomson <git@alfreido.com>
Date: Tue, 22 Nov 2022 17:06:17 +0800
Subject: [PATCH 3/6] Add test cases

---
 src/Parse/Markdown.php                        | 12 ++++++++-
 tests/Parse/MarkdownTest.php                  | 27 +++++++++++++++++++
 tests/fixtures/markdown/front_matter.html     |  2 ++
 tests/fixtures/markdown/front_matter.md       |  8 ++++++
 .../markdown/table_inline_markdown.html       |  4 +++
 .../markdown/table_inline_markdown.md         |  1 +
 .../table_inline_markdown_disabled.html       |  1 +
 7 files changed, 54 insertions(+), 1 deletion(-)
 create mode 100644 tests/fixtures/markdown/front_matter.html
 create mode 100644 tests/fixtures/markdown/front_matter.md
 create mode 100644 tests/fixtures/markdown/table_inline_markdown_disabled.html

diff --git a/src/Parse/Markdown.php b/src/Parse/Markdown.php
index 8fd1c26a5..d723d4549 100644
--- a/src/Parse/Markdown.php
+++ b/src/Parse/Markdown.php
@@ -292,12 +292,22 @@ protected function extractFrontMatter(string $markdown): string
     {
         $frontMatterParser = new FrontMatterParser(new SymfonyYamlFrontMatterParser);
         $parts = $frontMatterParser->parse($markdown);
-        $this->frontMatter = $parts->getFrontMatter() ?? [];
+        $this->frontMatterData = $parts->getFrontMatter() ?? [];
         $contents = $parts->getContent();
 
         return $contents;
     }
 
+    /**
+     * Gets the front matter extracted from the document.
+     *
+     * This should be called after the Markdown has been parsed.
+     */
+    public function getFrontMatter(): array
+    {
+        return $this->frontMatterData;
+    }
+
     /**
      * Gets an instance of the Markdown parser within a given environment.
      */
diff --git a/tests/Parse/MarkdownTest.php b/tests/Parse/MarkdownTest.php
index 1c667dcfd..e02b9356f 100644
--- a/tests/Parse/MarkdownTest.php
+++ b/tests/Parse/MarkdownTest.php
@@ -24,6 +24,33 @@ public function testParseSafe()
         $this->assertEquals($html, $this->removeLineEndings(Markdown::parseSafe($markdown)));
     }
 
+    public function testDisableAndEnableMethods()
+    {
+        $parser = Markdown::disableAutolinking()->disableTables();
+
+        $markdown = file_get_contents(dirname(__DIR__) . '/fixtures/markdown/table_inline_markdown.md');
+        $html = $this->removeLineEndings(file_get_contents(dirname(__DIR__) . '/fixtures/markdown/table_inline_markdown_disabled.html'));
+
+        $this->assertEquals($html, $this->removeLineEndings($parser->parse($markdown)));
+
+        // Re-enable tables and autolinking
+        $parser->enableAutolinking()->enableTables();
+
+        $html = $this->removeLineEndings(file_get_contents(dirname(__DIR__) . '/fixtures/markdown/table_inline_markdown.html'));
+
+        $this->assertEquals($html, $this->removeLineEndings($parser->parse($markdown)));
+    }
+
+    public function testFrontMatter()
+    {
+        $parser = Markdown::enableFrontMatter();
+
+        $markdown = file_get_contents(dirname(__DIR__) . '/fixtures/markdown/front_matter.md');
+        $html = $this->removeLineEndings(file_get_contents(dirname(__DIR__) . '/fixtures/markdown/front_matter.html'));
+
+        $this->assertEquals($html, $this->removeLineEndings($parser->parse($markdown)));
+    }
+
     /**
      * Data provider to provide test cases for Markdown parsing.
      *
diff --git a/tests/fixtures/markdown/front_matter.html b/tests/fixtures/markdown/front_matter.html
new file mode 100644
index 000000000..0ce25ebff
--- /dev/null
+++ b/tests/fixtures/markdown/front_matter.html
@@ -0,0 +1,2 @@
+<h1>Title</h1>
+<p>This is some content underneath the title.</p>
diff --git a/tests/fixtures/markdown/front_matter.md b/tests/fixtures/markdown/front_matter.md
new file mode 100644
index 000000000..32777a041
--- /dev/null
+++ b/tests/fixtures/markdown/front_matter.md
@@ -0,0 +1,8 @@
+---
+title: My document
+group: Documents
+meta_title: My document | My site
+---
+# Title
+
+This is some content underneath the title.
diff --git a/tests/fixtures/markdown/table_inline_markdown.html b/tests/fixtures/markdown/table_inline_markdown.html
index 5741858ba..57d711e52 100644
--- a/tests/fixtures/markdown/table_inline_markdown.html
+++ b/tests/fixtures/markdown/table_inline_markdown.html
@@ -22,5 +22,9 @@
 <td><code>\|</code> 2.1</td>
 <td><a href="/">link</a></td>
 </tr>
+<tr>
+<td><a href="https://google.com">https://google.com</a></td>
+<td>Autolink</td>
+</tr>
 </tbody>
 </table>
diff --git a/tests/fixtures/markdown/table_inline_markdown.md b/tests/fixtures/markdown/table_inline_markdown.md
index 2bd1b66ea..304a4f1f8 100644
--- a/tests/fixtures/markdown/table_inline_markdown.md
+++ b/tests/fixtures/markdown/table_inline_markdown.md
@@ -4,3 +4,4 @@
 | `|` broken   | \| 2.2       |
 | `\|` 2.1     | \| 2.2       |
 | `\\|` 2.1    | [link](/)    |
+| https://google.com | Autolink |
diff --git a/tests/fixtures/markdown/table_inline_markdown_disabled.html b/tests/fixtures/markdown/table_inline_markdown_disabled.html
new file mode 100644
index 000000000..dc1808249
--- /dev/null
+++ b/tests/fixtures/markdown/table_inline_markdown_disabled.html
@@ -0,0 +1 @@
+<p>| <em>header</em> 1   | header 2     || ------------ | ------------ || <em>cell</em> 1.1   | <del>cell</del> 1.2 || <code>|</code> broken   | | 2.2       || <code>\|</code> 2.1     | | 2.2       || <code>\\|</code> 2.1    | <a href="/">link</a>    || https://google.com | Autolink |</p>

From 6b6fc0c337b1ee526ea5a1f16adb05a51ef31f84 Mon Sep 17 00:00:00 2001
From: Ben Thomson <git@alfreido.com>
Date: Thu, 24 Nov 2022 21:45:00 +0800
Subject: [PATCH 4/6] Finalise implementation, documentation

---
 src/Parse/Markdown.php                  | 47 +++++++++++++++++++----
 src/Support/Facades/Markdown.php        | 51 +++++++++++++++++++++----
 tests/Parse/MarkdownTest.php            | 22 +++++++++++
 tests/fixtures/markdown/front_matter.md |  1 +
 4 files changed, 107 insertions(+), 14 deletions(-)

diff --git a/src/Parse/Markdown.php b/src/Parse/Markdown.php
index d723d4549..77206fd02 100644
--- a/src/Parse/Markdown.php
+++ b/src/Parse/Markdown.php
@@ -33,6 +33,38 @@
  *
  * @author Alexey Bobkov, Samuel Georges (Original implementation based on Parsedown)
  * @author Ben Thomson <git@alfreido.com> (Rewritten implementation using CommonMark)
+ *
+ * @method static enableAttributes()
+ * @method static enableAutolinking()
+ * @method static enableFootnotes()
+ * @method static enableFrontMatter()
+ * @method static enableHeadingPermalinks()
+ * @method static enableInlineOnly()
+ * @method static enableSafeMode()
+ * @method static enableTaskLists()
+ * @method static enableTables()
+ * @method static enableTableOfContents()
+ * @method static disableAttributes()
+ * @method static disableAutolinking()
+ * @method static disableFootnotes()
+ * @method static disableFrontMatter()
+ * @method static disableHeadingPermalinks()
+ * @method static disableInlineOnly()
+ * @method static disableSafeMode()
+ * @method static disableTaskLists()
+ * @method static disableTables()
+ * @method static disableTableOfContents()
+ * @method static \Winter\Storm\Parse\Markdown setAttributes(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setAutolinking(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setConfig(array $config)
+ * @method static \Winter\Storm\Parse\Markdown setFootnotes(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setFrontMatter(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setHeadingPermalinks(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setInlineOnly(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setSafeMode(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setTaskLists(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setTables(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setTableOfContents(bool $enabled)
  **/
 class Markdown
 {
@@ -98,11 +130,6 @@ class Markdown
      */
     protected ?array $frontMatterData = null;
 
-    /**
-     * Extracted table of contents from the Markdown content.
-     */
-    protected ?array $tableOfContentData = null;
-
     /**
      * The Markdown parser class to use.
      */
@@ -238,6 +265,9 @@ protected function createEnvironment(): Environment
             if ($this->autolinking) {
                 $environment->addExtension(new AutolinkExtension);
             }
+            if ($this->safeMode) {
+                $environment->addExtension(new DisallowedRawHtmlExtension);
+            }
         }
 
         return $environment;
@@ -260,8 +290,8 @@ protected function parseInternal(Environment $environment, string $markdown): st
     {
         $data = new MarkdownData($markdown);
 
-        $this->fireEvent('beforeParse', [$data], false);
-        Event::fire('markdown.beforeParse', [$data], false);
+        $this->fireEvent('beforeParse', [$data, $environment], false);
+        Event::fire('markdown.beforeParse', [$data, $environment], false);
 
         $markdown = $data->text;
 
@@ -269,6 +299,9 @@ protected function parseInternal(Environment $environment, string $markdown): st
         $parser = $this->getParser($environment);
         $document = $parser->parse($markdown);
 
+        $this->fireEvent('beforeRender', [$document, $environment], false);
+        Event::fire('markdown.beforeRender', [$document, $environment], false);
+
         // Render the AST as a HTML document
         $renderer = $this->getRenderer($environment);
         $rendered = $renderer->renderDocument($document);
diff --git a/src/Support/Facades/Markdown.php b/src/Support/Facades/Markdown.php
index dab18c2f0..b35e95c75 100644
--- a/src/Support/Facades/Markdown.php
+++ b/src/Support/Facades/Markdown.php
@@ -3,19 +3,56 @@
 use Winter\Storm\Support\Facade;
 
 /**
- * @method static string parse(string $text)
- * @method static string parseClean(string $text)
- * @method static string parseSafe(string $text)
- * @method static string parseLine(string $text)
+ * @method static string parse(string $markdown)
+ * @method static string parseClean(string $markdown)
+ * @method static string parseSafe(string $markdown)
+ * @method static string parseLine(string $markdown)
+ * @method static array getFrontMatter()
+ * @method static void setParser(\League\CommonMark\Parser\MarkdownParserInterface $parser)
+ * @method static void setRenderer(\League\CommonMark\Renderer\DocumentRendererInterface $renderer)
+ * @method static \Winter\Storm\Parse\Markdown enableAttributes()
+ * @method static \Winter\Storm\Parse\Markdown enableAutolinking()
+ * @method static \Winter\Storm\Parse\Markdown enableFootnotes()
+ * @method static \Winter\Storm\Parse\Markdown enableFrontMatter()
+ * @method static \Winter\Storm\Parse\Markdown enableHeadingPermalinks()
+ * @method static \Winter\Storm\Parse\Markdown enableInlineOnly()
+ * @method static \Winter\Storm\Parse\Markdown enableSafeMode()
+ * @method static \Winter\Storm\Parse\Markdown enableTaskLists()
+ * @method static \Winter\Storm\Parse\Markdown enableTables()
+ * @method static \Winter\Storm\Parse\Markdown enableTableOfContents()
+ * @method static \Winter\Storm\Parse\Markdown disableAttributes()
+ * @method static \Winter\Storm\Parse\Markdown disableAutolinking()
+ * @method static \Winter\Storm\Parse\Markdown disableFootnotes()
+ * @method static \Winter\Storm\Parse\Markdown disableFrontMatter()
+ * @method static \Winter\Storm\Parse\Markdown disableHeadingPermalinks()
+ * @method static \Winter\Storm\Parse\Markdown disableInlineOnly()
+ * @method static \Winter\Storm\Parse\Markdown disableSafeMode()
+ * @method static \Winter\Storm\Parse\Markdown disableTaskLists()
+ * @method static \Winter\Storm\Parse\Markdown disableTables()
+ * @method static \Winter\Storm\Parse\Markdown disableTableOfContents()
+ * @method static \Winter\Storm\Parse\Markdown setAttributes(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setAutolinking(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setConfig(array $config)
+ * @method static \Winter\Storm\Parse\Markdown setFootnotes(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setFrontMatter(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setHeadingPermalinks(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setInlineOnly(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setSafeMode(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setTaskLists(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setTables(bool $enabled)
+ * @method static \Winter\Storm\Parse\Markdown setTableOfContents(bool $enabled)
  *
  * @see \Winter\Storm\Parse\Markdown
  */
 class Markdown extends Facade
 {
     /**
-     * Get the registered name of the component.
-     *
-     * @return string
+     * {@inheritDoc}
+     */
+    protected static $cached = true;
+
+    /**
+     * {@inheritDoc}
      */
     protected static function getFacadeAccessor()
     {
diff --git a/tests/Parse/MarkdownTest.php b/tests/Parse/MarkdownTest.php
index e02b9356f..82fb24416 100644
--- a/tests/Parse/MarkdownTest.php
+++ b/tests/Parse/MarkdownTest.php
@@ -4,6 +4,13 @@
 
 class MarkdownTest extends TestCase
 {
+    /**
+     * Test fixtures that should be skipped by the data provider.
+     */
+    protected array $specialTests = [
+        'front_matter',
+    ];
+
     /**
      * @dataProvider markdownData
      * @param string $name
@@ -49,6 +56,18 @@ public function testFrontMatter()
         $html = $this->removeLineEndings(file_get_contents(dirname(__DIR__) . '/fixtures/markdown/front_matter.html'));
 
         $this->assertEquals($html, $this->removeLineEndings($parser->parse($markdown)));
+        $this->assertEquals([
+            'title' => 'My document',
+            'group' => 'Documents',
+            'meta_title' => 'My document | My site',
+            'show_contents' => true,
+        ], $parser->getFrontMatter());
+
+        // Test document with no front matter
+        $markdown = file_get_contents(dirname(__DIR__) . '/fixtures/markdown/code_block.md');
+        $parser = Markdown::enableFrontMatter();
+        $parser->parse($markdown);
+        $this->assertCount(0, $parser->getFrontMatter());
     }
 
     /**
@@ -68,6 +87,9 @@ public function markdownData()
                 if ($name === 'README') {
                     continue;
                 }
+                if (in_array($name, $this->specialTests)) {
+                    continue;
+                }
 
                 $markdown = file_get_contents($dirName . DIRECTORY_SEPARATOR . $name . '.md');
                 $html = $this->removeLineEndings(file_get_contents($dirName . DIRECTORY_SEPARATOR . $name . '.html'));
diff --git a/tests/fixtures/markdown/front_matter.md b/tests/fixtures/markdown/front_matter.md
index 32777a041..ba5a5e77d 100644
--- a/tests/fixtures/markdown/front_matter.md
+++ b/tests/fixtures/markdown/front_matter.md
@@ -2,6 +2,7 @@
 title: My document
 group: Documents
 meta_title: My document | My site
+show_contents: true
 ---
 # Title
 

From b13fde2757efa79bb940c5f9762976d4f8fd763d Mon Sep 17 00:00:00 2001
From: Ben Thomson <git@alfreido.com>
Date: Fri, 25 Nov 2022 16:51:22 +0800
Subject: [PATCH 5/6] Remove final from CommonMarkCoreExtension

---
 src/Parse/Markdown/CommonMarkCoreExtension.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Parse/Markdown/CommonMarkCoreExtension.php b/src/Parse/Markdown/CommonMarkCoreExtension.php
index de3614626..115535781 100644
--- a/src/Parse/Markdown/CommonMarkCoreExtension.php
+++ b/src/Parse/Markdown/CommonMarkCoreExtension.php
@@ -26,7 +26,7 @@
 use League\Config\ConfigurationBuilderInterface;
 use Nette\Schema\Expect;
 
-final class CommonMarkCoreExtension implements ConfigurableExtensionInterface
+class CommonMarkCoreExtension implements ConfigurableExtensionInterface
 {
     public function configureSchema(ConfigurationBuilderInterface $builder): void
     {

From c88c2b8760b0efe27d185728db4663c9ee3e38f9 Mon Sep 17 00:00:00 2001
From: Ben Thomson <git@alfreido.com>
Date: Sat, 26 Nov 2022 13:46:41 +0800
Subject: [PATCH 6/6] Update src/Support/Facades/Markdown.php

---
 src/Support/Facades/Markdown.php | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Support/Facades/Markdown.php b/src/Support/Facades/Markdown.php
index b35e95c75..a28e5420b 100644
--- a/src/Support/Facades/Markdown.php
+++ b/src/Support/Facades/Markdown.php
@@ -49,7 +49,7 @@ class Markdown extends Facade
     /**
      * {@inheritDoc}
      */
-    protected static $cached = true;
+    protected static $cached = false;
 
     /**
      * {@inheritDoc}