Use psalm --shepherd

Fixes https://github.com/erusev/parsedown/issues/681

.gitattributes

@@ -0,0 +1,6 @@
+# Ignore all tests for archive
+/test               export-ignore
+/.gitattributes     export-ignore
+/.gitignore         export-ignore
+/.travis.yml        export-ignore
+/phpunit.xml.dist   export-ignore

.gitignore

@@ -1,3 +1,4 @@
-.DS_Store
-.idea
-nbproject
+composer.lock
+vendor/
+infection.log
+tests/spec_cache.txt

.php_cs.dist

@@ -0,0 +1,37 @@
+<?php
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+$finder = Finder::create()
+    ->in(__DIR__ . '/src/')
+    ->in(__DIR__ . '/tests/')
+;
+$rules = [
+    '@PSR2' => true,
+    'array_syntax' => [
+        'syntax' => 'short',
+    ],
+    'braces' => [
+        'allow_single_line_closure' => true,
+    ],
+    'logical_operators' => true,
+    'native_constant_invocation' => [
+        'fix_built_in' => true,
+    ],
+    'native_function_invocation' => [
+        'include' => ['@all'],
+    ],
+    'no_unused_imports' => true,
+    'ordered_imports' => [
+        'sort_algorithm' => 'alpha',
+    ],
+    'single_blank_line_before_namespace' => true,
+    'strict_comparison' => true,
+    'strict_param' => true,
+    'whitespace_after_comma_in_array' => true,
+];
+return Config::create()
+    ->setRules($rules)
+    ->setFinder($finder)
+    ->setUsingCache(false)
+    ->setRiskyAllowed(true)
+;

.travis.yml

@@ -1,6 +1,73 @@
 language: php
 
-php:
-  - 5.5
-  - 5.4
-  - 5.3
+dist: trusty
+sudo: false
+
+stages:
+  - Code Format and Static Analysis
+  - Units
+  - Test CommonMark (weak)
+
+matrix:    
+  fast_finish: true
+  allow_failures:
+    - env: ALLOW_FAILURE
+
+cache:
+  directories:
+    - $HOME/.composer/cache
+
+jobs:
+  include:
+    - stage: Code Format and Static Analysis
+      php: 7.3
+      install: composer install --prefer-dist --no-interaction --no-progress
+      script:
+        - '[ -z "$TRAVIS_TAG" ] || [ "$TRAVIS_TAG" == "$(php -r "require(\"vendor/autoload.php\"); echo Erusev\Parsedown\Parsedown::version;")" ]'
+        - composer test-static -- --shepherd
+        - composer test-formatting
+        - composer test-dead-code
+
+
+    - &UNIT_TEST
+      stage: Units
+      php: 5.5
+      install:
+        # remove packages with PHP requirements higher than 7.0 to prevent composer trying to resolve these, see: https://github.com/composer/composer/issues/6011
+        - composer remove vimeo/psalm friendsofphp/php-cs-fixer infection/infection --dev --no-update --no-interaction
+        - composer install --prefer-dist --no-interaction --no-progress
+      script: composer test-units
+    - <<: *UNIT_TEST
+      php: 5.6
+    - <<: *UNIT_TEST
+      php: 7.0
+    - &MUTATION_AND_UNIT_TEST
+      <<: *UNIT_TEST
+      php: 7.1
+      install:
+        - composer install --prefer-dist --no-interaction --no-progress
+      script:
+        - composer test-units
+        - vendor/bin/infection --show-mutations --threads=4 --min-msi=90 --min-covered-msi=90
+    - <<: *MUTATION_AND_UNIT_TEST
+      php: 7.2
+    - <<: *MUTATION_AND_UNIT_TEST
+      php: 7.3
+    - <<: *UNIT_TEST
+      php: nightly
+      env: ALLOW_FAILURE
+
+
+    - &COMMONMARK_TEST
+      stage: CommonMark
+      name: Weak
+      php: 7.3
+      env: ALLOW_FAILURE
+      install: composer install --prefer-dist --no-interaction --no-progress
+      script:
+        - composer test-commonmark-weak
+
+    - <<: *COMMONMARK_TEST
+      name: Strict
+      script:
+        - composer test-commonmark

LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013 Emanuil Rusev, erusev.com
+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
@@ -17,4 +17,4 @@ 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.
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Parsedown.php

@@ -1,688 +0,0 @@
-<?php 
-
-# 
-# 
-# Parsedown
-# http://parsedown.org
-# 
-# (c) Emanuil Rusev 
-# http://erusev.com
-# 
-# For the full license information, please view the LICENSE file that was 
-# distributed with this source code.
-# 
-# 
-
-class Parsedown
-{
-	# 
-	# Multiton (http://en.wikipedia.org/wiki/Multiton_pattern) 
-	# 
-	
-	static function instance($name = 'default')
-	{
-		if (isset(self::$instances[$name]))
-			return self::$instances[$name];
-		
-		$instance = new Parsedown();
-		
-		self::$instances[$name] = $instance;
-		
-		return $instance;
-	}
-	
-	private static $instances = array();
-	
-	# 
-	# Fields 
-	# 
-	
-	private $reference_map = array();
-	private $escape_sequence_map = array();
-	
-	# 
-	# Public Methods 
-	# 
-	
-	function parse($text)
-	{	
-		# Removes UTF-8 BOM and marker characters.
-		$text = preg_replace('{^\xEF\xBB\xBF|\x1A}', '', $text);
-		
-		# Removes \r characters.
-		$text = str_replace("\r\n", "\n", $text);
-		$text = str_replace("\r", "\n", $text);
-		
-		# Replaces tabs with spaces.
-		$text = str_replace("\t", '    ', $text);
-		
-		# Encodes escape sequences.
-		
-		if (strpos($text, '\\') !== FALSE)
-		{
-			$escape_sequences = array('\\\\', '\`', '\*', '\_', '\{', '\}', '\[', '\]', '\(', '\)', '\>', '\#', '\+', '\-', '\.', '\!');
-			
-			foreach ($escape_sequences as $index => $escape_sequence)
-			{
-				if (strpos($text, $escape_sequence) !== FALSE)
-				{
-					$code = "\x1A".'\\'.$index;
-					
-					$text = str_replace($escape_sequence, $code, $text);
-					
-					$this->escape_sequence_map[$code] = $escape_sequence;
-				}
-			}
-		}
-		
-		# ~ 
-		
-		$text = preg_replace('/\n\s*\n/', "\n\n", $text);
-		$text = trim($text, "\n ");
-		
-		$lines = explode("\n", $text);
-		
-		$text = $this->parse_block_elements($lines);
-		
-		# Decodes escape sequences (leaves out backslashes).
-		
-		foreach ($this->escape_sequence_map as $code => $escape_sequence)
-		{
-			$text = str_replace($code, $escape_sequence[1], $text);
-		}
-		
-		$text = rtrim($text, "\n");
-		
-		return $text;
-	}
-	
-	# 
-	# Private Methods 
-	# 
-	
-	private function parse_block_elements(array $lines, $context = '')
-	{
-		$elements = array();
-		
-		$element = array(
-			'type' => '',
-		);
-		
-		foreach ($lines as $line)
-		{
-			# Block-Level HTML 
-			
-			if ($element['type'] === 'block' and ! isset($element['closed']))
-			{
-				if (preg_match('{<'.$element['subtype'].'>$}', $line)) # <open>
-				{
-					$element['depth']++;
-				}
-				
-				if (preg_match('{</'.$element['subtype'].'>$}', $line)) # </close>
-				{
-					$element['depth'] > 0 
-						? $element['depth']-- 
-						: $element['closed'] = true;
-				}
-				
-				$element['text'] .= "\n".$line;
-
-				continue;
-			}
-			
-			# Empty 
-			
-			if ($line === '')
-			{
-				$element['interrupted'] = true;
-				
-				continue;
-			}
-			
-			# Lazy Blockquote 
-			
-			if ($element['type'] === 'blockquote' and ! isset($element['interrupted']))
-			{
-				$line = preg_replace('/^[ ]*>[ ]?/', '', $line);
-				
-				$element['lines'] []= $line;
-				
-				continue;
-			}
-			
-			# Lazy List Item 
-			
-			if ($element['type'] === 'li')
-			{
-				if (preg_match('/^([ ]{0,3})(\d+[.]|[*+-])[ ](.*)/', $line, $matches))
-				{
-					if ($element['indentation'] !== $matches[1]) 
-					{
-						$element['lines'] []= $line;
-					}
-					else 
-					{
-						unset($element['last']);
-						
-						$elements []= $element;
-						
-						$element = array(
-							'type' => 'li',
-							'indentation' => $matches[1],
-							'last' => true,
-							'lines' => array(
-								preg_replace('/^[ ]{0,4}/', '', $matches[3]),
-							),
-						);
-					}
-					
-					continue;
-				}
-				
-				if (isset($element['interrupted']))
-				{
-					if ($line[0] === ' ')
-					{
-						$element['lines'] []= '';
-						
-						$line = preg_replace('/^[ ]{0,4}/', '', $line);;
-						
-						$element['lines'] []= $line;
-						
-						continue;
-					}
-				}
-				else
-				{
-					$line = preg_replace('/^[ ]{0,4}/', '', $line);;
-						
-					$element['lines'] []= $line;
-					
-					continue;
-				}
-			}
-			
-			# Quick Paragraph 
-			
-			if ($line[0] >= 'A' and $line[0] !== '_' and $line[0] !== '[')
-			{
-				goto paragraph; # trust me 
-			}
-			
-			# Code 
-			
-			if ($line[0] === ' ' and preg_match('/^[ ]{4}(.*)/', $line, $matches))
-			{
-				if ($element['type'] === 'code')
-				{
-					if (isset($element['interrupted']))
-					{
-						$element['text'] .= "\n";
-						
-						unset ($element['interrupted']);
-					}
-					
-					$element['text'] .= "\n".$matches[1];
-				}
-				else
-				{
-					$elements []= $element;
-					
-					$element = array(
-						'type' => 'code',
-						'text' => $matches[1],
-					);
-				}
-
-				continue;
-			}
-			
-			# Setext Header (---)  
-			
-			if ($line[0] === '-' and $element['type'] === 'p' and ! isset($element['interrupted']) and preg_match('/^[-]+[ ]*$/', $line))
-			{
-				$element['type'] = 'h.';
-				$element['level'] = 2;
-				
-				continue;
-			}
-			
-			# Atx Header (#)
-			
-			if ($line[0] === '#' and preg_match('/^(#{1,6})[ ]*(.+?)[ ]*#*$/', $line, $matches))
-			{
-				$elements []= $element;
-				
-				$level = strlen($matches[1]);
-				
-				$element = array(
-					'type' => 'h.',
-					'text' => $matches[2],
-					'level' => $level,
-				);
-				
-				continue;
-			}
-			
-			# Setext Header (===) 
-			
-			if ($line[0] === '=' and $element['type'] === 'p' and ! isset($element['interrupted']) and preg_match('/^[=]+[ ]*$/', $line))
-			{
-				$element['type'] = 'h.';
-				$element['level'] = 1;
-				
-				continue;
-			}
-			
-			# ~ 
-			
-			$pure_line = ltrim($line);
-			
-			# Link Reference 
-			
-			if ($pure_line[0] === '[' and preg_match('/^\[(.+?)\]:[ ]*([^ ]+)/', $pure_line, $matches))
-			{
-				$label = $matches[1];
-				$url = trim($matches[2], '<>');
-				
-				$this->reference_map[$label] = $url;
-				
-				continue;
-			}
-			
-			# Blockquote 
-			
-			if ($pure_line[0] === '>' and preg_match('/^>[ ]?(.*)/', $pure_line, $matches))
-			{
-				if ($element['type'] === 'blockquote')
-				{
-					if (isset($element['interrupted']))
-					{
-						$element['lines'] []= '';
-						
-						unset($element['interrupted']);
-					}
-					
-					$element['lines'] []= $matches[1];
-				}
-				else
-				{
-					$elements []= $element;
-					
-					$element = array(
-						'type' => 'blockquote',
-						'lines' => array(
-							$matches[1],
-						),
-					);
-				}
-				
-				continue;
-			}
-			
-			# HTML  
-			
-			if ($pure_line[0] === '<')
-			{
-				# Block-Level HTML <self-closing/>
-
-				if (preg_match('{^<.+?/>$}', $pure_line))
-				{
-					$elements []= $element;
-
-					$element = array(
-						'type' => '',
-						'text' => $pure_line,
-					);
-
-					continue;
-				}
-				
-				# Block-Level HTML <open>
-
-				if (preg_match('{^<(\w+)(?:[ ].*?)?>}', $pure_line, $matches))
-				{
-					$elements []= $element;
-
-					$element = array(
-						'type' => 'block',
-						'subtype' => strtolower($matches[1]),
-						'text' => $pure_line,
-						'depth' => 0,
-					);
-					
-					preg_match('{</'.$matches[1].'>\s*$}', $pure_line) and $element['closed'] = true;
-
-					continue;
-				}
-			}
-			
-			# Horizontal Rule   
-			
-			if (preg_match('/^([-*_])([ ]{0,2}\1){2,}[ ]*$/', $pure_line))
-			{
-				$elements []= $element;
-				
-				$element = array(
-					'type' => 'hr',
-				);
-				
-				continue;
-			}
-			
-			# List Item 
-			
-			if (preg_match('/^([ ]*)(\d+[.]|[*+-])[ ](.*)/', $line, $matches))
-			{
-				$elements []= $element;
-				
-				$element = array(
-					'type' => 'li',
-					'ordered' => isset($matches[2][1]),
-					'indentation' => $matches[1],
-					'last' => true,
-					'lines' => array(
-						preg_replace('/^[ ]{0,4}/', '', $matches[3]),
-					),
-				);
-				
-				continue;
-			}
-			
-			# ~ 
-			
-			paragraph:
-			
-			if ($element['type'] === 'p')
-			{
-				if (isset($element['interrupted']))
-				{
-					$elements []= $element;
-					
-					$element['text'] = $line;
-					
-					unset($element['interrupted']);
-				}
-				else
-				{
-					$element['text'] .= "\n".$line;
-				}
-			}
-			else
-			{
-				$elements []= $element;
-				
-				$element = array(
-					'type' => 'p', 
-					'text' => $line,
-				);
-			}
-		}
-		
-		$elements []= $element;
-		
-		array_shift($elements);
-		
-		# 
-		# ~ 
-		# 
-		
-		$markup = '';
-		
-		foreach ($elements as $index => $element)
-		{
-			switch ($element['type'])
-			{
-				case 'li':
-					
-					if (isset($element['ordered'])) # first
-					{
-						$list_type = $element['ordered'] ? 'ol' : 'ul';
-						
-						$markup .= '<'.$list_type.'>'."\n";
-					}
-					
-					if (isset($element['interrupted']) and ! isset($element['last']))
-					{
-						$element['lines'] []= '';
-					}
-					
-					$text = $this->parse_block_elements($element['lines'], 'li');
-					
-					$markup .= '<li>'.$text.'</li>'."\n";
-					
-					isset($element['last']) and $markup .= '</'.$list_type.'>'."\n";
-					
-					break;
-				
-				case 'p':
-					
-					$text = $this->parse_inline_elements($element['text']);
-					
-					$text = preg_replace('/[ ]{2}\n/', '<br />'."\n", $text);
-					
-					if ($context === 'li' and $index === 0)
-					{
-						if (isset($element['interrupted']))
-						{
-							$markup .= "\n".'<p>'.$text.'</p>'."\n";
-						}
-						else 
-						{
-							$markup .= $text;
-						}
-					}
-					else 
-					{
-						$markup .= '<p>'.$text.'</p>'."\n";
-					}
-					
-					break;
-				
-				case 'code':
-					
-					$text = htmlentities($element['text'], ENT_NOQUOTES);
-					
-					strpos($text, "\x1A\\") !== FALSE and $text = strtr($text, $this->escape_sequence_map);
-					
-					$markup .= '<pre><code>'.$text.'</code></pre>'."\n";
-					
-					break;
-				
-				case 'blockquote':
-					
-					$text = $this->parse_block_elements($element['lines']);
-					
-					$markup .= '<blockquote>'."\n".$text.'</blockquote>'."\n";
-					
-					break;
-				
-				case 'h.':
-					
-					$text = $this->parse_inline_elements($element['text']);
-					
-					$markup .= '<h'.$element['level'].'>'.$text.'</h'.$element['level'].'>'."\n";
-					
-					break;
-				
-				case 'hr':
-					
-					$markup .= '<hr />'."\n";
-					
-					break;
-
-				default:
-					
-					$markup .= $element['text']."\n";
-			}
-		}
-		
-		return $markup;
-	}
-	
-	private function parse_inline_elements($text)
-	{
-		$map = array();
-		
-		$index = 0;
-		
-		# Code Span 
-		
-		if (strpos($text, '`') !== FALSE and preg_match_all('/`(.+?)`/', $text, $matches, PREG_SET_ORDER)) 
-		{
-			foreach ($matches as $matches)
-			{
-				$element_text = $matches[1];
-				$element_text = htmlentities($element_text, ENT_NOQUOTES);
-				
-				# Decodes escape sequences.
-				
-				$this->escape_sequence_map 
-					and strpos($element_text, "\x1A") !== FALSE 
-					and $element_text = strtr($element_text, $this->escape_sequence_map);
-				
-				# Composes element.
-				
-				$element = '<code>'.$element_text.'</code>';
-				
-				# Encodes element.
-				
-				$code = "\x1A".'$'.$index;
-				
-				$text = str_replace($matches[0], $code, $text);
-				
-				$map[$code] = $element;
-				
-				$index ++;
-			}
-		}
-		
-		# Inline Link / Image 
-		
-		if (strpos($text, '](') !== FALSE and preg_match_all('/(!?)(\[((?:[^][]+|(?2))*)\])\((.*?)\)/', $text, $matches, PREG_SET_ORDER)) # inline 
-		{
-			foreach ($matches as $matches)
-			{
-				$url = $this->escape_special_characters($matches[4]);
-				
-				if ($matches[1]) # image 
-				{
-					$element = '<img alt="'.$matches[3].'" src="'.$url.'">';
-				}
-				else
-				{
-					$element_text = $this->parse_inline_elements($matches[3]);
-					
-					$element = '<a href="'.$url.'">'.$element_text.'</a>';
-				}
-				
-				# ~ 
-
-				$code = "\x1A".'$'.$index;
-
-				$text = str_replace($matches[0], $code, $text);
-
-				$map[$code] = $element;
-				
-				$index ++;
-			}
-		}
-		
-		# Reference(d) Link / Image 
-		
-		if ($this->reference_map and strpos($text, '[') !== FALSE and preg_match_all('/(!?)\[(.+?)\](?:\n?[ ]?\[(.*?)\])?/ms', $text, $matches, PREG_SET_ORDER))
-		{
-			foreach ($matches as $matches)
-			{
-				$link_definition = isset($matches[3]) && $matches[3]
-					? $matches[3]
-					: $matches[2]; # implicit 
-				
-				$link_definition = strtolower($link_definition);
-				
-				if (isset($this->reference_map[$link_definition]))
-				{
-					$url = $this->reference_map[$link_definition];
-					$url = $this->escape_special_characters($url);
-					
-					if ($matches[1]) # image 
-					{
-						$element = '<img alt="'.$matches[2].'" src="'.$url.'">';
-					}
-					else # anchor 
-					{
-						$element_text = $this->parse_inline_elements($matches[2]);
-
-						$element = '<a href="'.$url.'">'.$element_text.'</a>';
-					}
-
-					# ~ 
-
-					$code = "\x1A".'$'.$index;
-
-					$text = str_replace($matches[0], $code, $text);
-
-					$map[$code] = $element;
-
-					$index ++;
-				}
-			}
-		}
-		
-		# Automatic Links 
-		
-		if (strpos($text, '<') !== FALSE and preg_match_all('/<((https?|ftp|dict):[^\^\s]+?)>/i', $text, $matches, PREG_SET_ORDER))
-		{
-			foreach ($matches as $matches)
-			{
-				$url = $this->escape_special_characters($matches[1]);
-				
-				$element = '<a href=":href">:text</a>';
-				$element = str_replace(':text', $url, $element);
-				$element = str_replace(':href', $url, $element);
-				
-				# ~ 
-				
-				$code = "\x1A".'$'.$index;
-				
-				$text = str_replace($matches[0], $code, $text);
-				
-				$map[$code] = $element;
-				
-				$index ++;
-			}
-		}
-		
-		# ~ 
-		
-		$text = $this->escape_special_characters($text);
-
-		# ~ 
-		
-		if (strpos($text, '_') !== FALSE)
-		{
-			$text = preg_replace('/__(?=\S)(.+?)(?<=\S)__/', '<strong>$1</strong>', $text);
-			$text = preg_replace('/_(?=\S)(.+?)(?<=\S)_/', '<em>$1</em>', $text);
-		}
-		
-		if (strpos($text, '*') !== FALSE)
-		{
-			$text = preg_replace('/\*\*(?=\S)(.+?)(?<=\S)\*\*/', '<strong>$1</strong>', $text);
-			$text = preg_replace('/\*(?=\S)(.+?)(?<=\S)\*/', '<em>$1</em>', $text);
-		}
-		
-		$text = strtr($text, $map);
-		
-		return $text;
-	}
-	
-	private function escape_special_characters($text)
-	{
-		strpos($text, '&') !== FALSE and $text = preg_replace('/&(?!#?\w+;)/', '&amp;', $text);
-		
-		$text = str_replace('<', '&lt;', $text);
-		
-		return $text;
-	}
-}

README.md

@@ -1,20 +1,99 @@
-## Parsedown PHP
+<!-- ![Parsedown](https://i.imgur.com/yE8afYV.png) -->
 
-Parsedown is a parser for Markdown. It parses Markdown text the way people do. First, it divides texts into blocks. Then it looks at how these blocks start and how they relate to each other. Finally, it looks for special characters to identify inline elements. As a result, Parsedown is (super) fast, consistent and clean.
+<p align="center"><img alt="Parsedown" src="https://i.imgur.com/fKVY6Kz.png" width="240" /></p>
 
-[Explorer (demo)](http://parsedown.org/explorer/)  
-[Tests](http://parsedown.org/tests/)
+<h1>Parsedown</h1>
 
-### Installation
+[![Build Status](https://travis-ci.org/erusev/parsedown.svg)](https://travis-ci.org/erusev/parsedown)
+[![Total Downloads](https://poser.pugx.org/erusev/parsedown/d/total.svg)](https://packagist.org/packages/erusev/parsedown)
+[![Version](https://poser.pugx.org/erusev/parsedown/v/stable.svg)](https://packagist.org/packages/erusev/parsedown)
+[![License](https://poser.pugx.org/erusev/parsedown/license.svg)](https://packagist.org/packages/erusev/parsedown)
 
-Include `Parsedown.php` or install [the composer package](https://packagist.org/packages/erusev/parsedown).
+Better Markdown Parser in PHP - <a href="http://parsedown.org/demo">Demo</a>.
 
-### Example
+## Features
+
+* One File
+* No Dependencies
+* [Super Fast](http://parsedown.org/speed)
+* Extensible
+* [GitHub flavored](https://help.github.com/articles/github-flavored-markdown)
+* Tested in 5.5 to 7.3
+* [Markdown Extra extension](https://github.com/erusev/parsedown-extra)
+
+## Installation
+
+Install the [composer package]:
+
+    composer require erusev/parsedown
+
+Or download the [latest release] and include `Parsedown.php`
+
+[composer package]: https://packagist.org/packages/erusev/parsedown "The Parsedown package on packagist.org"
+[latest release]: https://github.com/erusev/parsedown/releases/latest "The latest release of Parsedown"
+
+## Example
 
 ```php
-$text = 'Hello **Parsedown**!';
+$Parsedown = new Parsedown();
 
-$result = Parsedown::instance()->parse($text);
+echo $Parsedown->text('Hello _Parsedown_!'); # prints: <p>Hello <em>Parsedown</em>!</p>
+```
 
-echo $result; # prints: <p>Hello <strong>Parsedown</strong>!</p>
-```
+You can also parse inline markdown only:
+
+```php
+echo $Parsedown->line('Hello _Parsedown_!'); # prints: Hello <em>Parsedown</em>!
+```
+
+More examples in [the wiki](https://github.com/erusev/parsedown/wiki/) and in [this video tutorial](http://youtu.be/wYZBY8DEikI).
+
+## Security
+
+Parsedown is capable of escaping user-input within the HTML that it generates. Additionally Parsedown will apply sanitisation to additional scripting vectors (such as scripting link destinations) that are introduced by the markdown syntax itself.
+
+To tell Parsedown that it is processing untrusted user-input, use the following:
+
+```php
+$Parsedown->setSafeMode(true);
+```
+
+If instead, you wish to allow HTML within untrusted user-input, but still want output to be free from XSS it is recommended that you make use of a HTML sanitiser that allows HTML tags to be whitelisted, like [HTML Purifier](http://htmlpurifier.org/).
+
+In both cases you should strongly consider employing defence-in-depth measures, like [deploying a Content-Security-Policy](https://scotthelme.co.uk/content-security-policy-an-introduction/) (a browser security feature) so that your page is likely to be safe even if an attacker finds a vulnerability in one of the first lines of defence above.
+
+#### Security of Parsedown Extensions
+
+Safe mode does not necessarily yield safe results when using extensions to Parsedown. Extensions should be evaluated on their own to determine their specific safety against XSS.
+
+## Escaping HTML
+
+> ⚠️  **WARNING:** This method isn't safe from XSS!
+
+If you wish to escape HTML **in trusted input**, you can use the following:
+
+```php
+$Parsedown->setMarkupEscaped(true);
+```
+
+Beware that this still allows users to insert unsafe scripting vectors, such as links like `[xss](javascript:alert%281%29)`.
+
+## Questions
+
+**How does Parsedown work?**
+
+It tries to read Markdown like a human. First, it looks at the lines. It’s interested in how the lines start. This helps it recognise blocks. It knows, for example, that if a line starts with a `-` then perhaps it belongs to a list. Once it recognises the blocks, it continues to the content. As it reads, it watches out for special characters. This helps it recognise inline elements (or inlines).
+
+We call this approach "line based". We believe that Parsedown is the first Markdown parser to use it. Since the release of Parsedown, other developers have used the same approach to develop other Markdown parsers in PHP and in other languages.
+
+**Is it compliant with CommonMark?**
+
+It passes most of the CommonMark tests. Most of the tests that don't pass deal with cases that are quite uncommon. Still, as CommonMark matures, compliance should improve.
+
+**Who uses it?**
+
+[Laravel Framework](https://laravel.com/), [Bolt CMS](http://bolt.cm/), [Grav CMS](http://getgrav.org/), [Herbie CMS](http://www.getherbie.org/), [Kirby CMS](http://getkirby.com/), [October CMS](http://octobercms.com/), [Pico CMS](http://picocms.org), [Statamic CMS](http://www.statamic.com/), [phpDocumentor](http://www.phpdoc.org/), [RaspberryPi.org](http://www.raspberrypi.org/), [Symfony Demo](https://github.com/symfony/demo) and [more](https://packagist.org/packages/erusev/parsedown/dependents).
+
+**How can I help?**
+
+Use it, star it, share it and if you feel generous, [donate](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=528P3NZQMP8N2).

composer.json

@@ -12,7 +12,36 @@
             "homepage": "http://erusev.com"
         }
     ],
+    "require": {
+        "php": "^7||^5.5",
+        "ext-mbstring": "*"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^7.4||^6.5.13||^5.7.27||^4.8.36",
+        "vimeo/psalm": "^3.2.7",
+        "friendsofphp/php-cs-fixer": "^2.13",
+        "infection/infection": "^0.12.0"
+    },
     "autoload": {
-        "psr-0": {"Parsedown": ""}
+        "psr-4": {"Erusev\\Parsedown\\": "src/"}
+    },
+    "autoload-dev": {
+        "psr-4": {"Erusev\\Parsedown\\Tests\\": "tests/"}
+    },
+    "scripts": {
+        "test": [
+            "@test-static",
+            "@test-formatting",
+            "@test-dead-code",
+            "@test-units"
+        ],
+        "test-static": "vendor/bin/psalm",
+        "test-dead-code": "vendor/bin/psalm --find-dead-code",
+        "test-units": "vendor/bin/phpunit",
+        "test-commonmark": "vendor/bin/phpunit tests/CommonMarkTestStrict.php",
+        "test-commonmark-weak": "vendor/bin/phpunit tests/CommonMarkTestWeak.php",
+        "test-formatting": "@composer fix -- --dry-run",
+
+        "fix": "vendor/bin/php-cs-fixer fix --verbose --show-progress=dots --diff"
     }
-}
+}

infection.json.dist

@@ -0,0 +1,18 @@
+{
+    "timeout": 10,
+    "source": {
+        "directories": [
+            "src"
+        ]
+    },
+    "logs": {
+        "text": "infection.log"
+    },
+    "mutators": {
+        "@default": true,
+        "@cast": false,
+        "This": false,
+        "FunctionCall": false,
+        "NewObject": false
+    }
+}

phpunit.xml.dist

@@ -1,8 +1,15 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<phpunit colors="true">
+<phpunit bootstrap="vendor/autoload.php" colors="true">
 	<testsuites>
-		<testsuite>
-			<file>tests/Test.php</file>
+		<testsuite name="ParsedownTests">
+			<file>tests/ParsedownTest.php</file>
+			<file>tests/CommonMarkTest.php</file>
+			<directory suffix="Test.php">./tests/src</directory>
 		</testsuite>
 	</testsuites>
-</phpunit>
+	<groups>
+		<exclude>
+			<group>update</group>
+		</exclude>
+	</groups>
+</phpunit>

psalm.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0"?>
+<psalm
+    totallyTyped="true"
+    strictBinaryOperands="true"
+    checkForThrowsDocblock="true"
+>
+    <projectFiles>
+        <directory name="src" />
+        <directory name="tests" />
+    </projectFiles>
+
+    <issueHandlers>
+        <PossiblyUnusedMethod>
+            <errorLevel type="suppress">
+                <directory name="tests" />
+            </errorLevel>
+        </PossiblyUnusedMethod>
+        <PropertyNotSetInConstructor>
+            <errorLevel type="suppress"><directory name="tests" /></errorLevel>
+        </PropertyNotSetInConstructor>
+        <UnusedClass>
+            <errorLevel type="suppress"><directory name="tests/src" /></errorLevel>
+        </UnusedClass>
+        <UndefinedInterfaceMethod>
+            <errorLevel type="suppress"><directory name="tests/src" /></errorLevel>
+        </UndefinedInterfaceMethod>
+        <PossiblyNullArrayAccess>
+            <errorLevel type="suppress"><directory name="tests/src" /></errorLevel>
+        </PossiblyNullArrayAccess>
+        <PossiblyNullReference>
+            <errorLevel type="suppress"><directory name="tests/src" /></errorLevel>
+        </PossiblyNullReference>
+    </issueHandlers>
+</psalm>

src/AST/Handler.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Erusev\Parsedown\AST;
+
+use Erusev\Parsedown\Html\Renderable;
+use Erusev\Parsedown\State;
+
+/**
+ * @template T as Renderable
+ */
+final class Handler implements StateRenderable
+{
+    /** @var callable(State):T */
+    private $closure;
+
+    /**
+     * @param callable(State):T $closure
+     */
+    public function __construct(callable $closure)
+    {
+        $this->closure = $closure;
+    }
+
+    /**
+     * @param State $State
+     * @return T&Renderable
+     */
+    public function renderable(State $State)
+    {
+        $closure = $this->closure;
+
+        return $closure($State);
+    }
+}

src/AST/StateRenderable.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Erusev\Parsedown\AST;
+
+use Erusev\Parsedown\Html\Renderable;
+use Erusev\Parsedown\State;
+
+interface StateRenderable
+{
+    /**
+     * @param State $State
+     * @return Renderable
+     */
+    public function renderable(State $State);
+}

src/Component.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Erusev\Parsedown;
+
+use Erusev\Parsedown\AST\StateRenderable;
+
+interface Component
+{
+    /**
+     * @return StateRenderable
+     */
+    public function stateRenderable();
+}

src/Components/AcquisitioningBlock.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Erusev\Parsedown\Components;
+
+interface AcquisitioningBlock extends Block
+{
+    /**
+     * Return true if the block was built encompassing the previous block
+     * $Block given to static::build, return false otherwise.
+     * @return bool
+     */
+    public function acquiredPrevious();
+}

src/Components/BacktrackingInline.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Erusev\Parsedown\Components;
+
+use Erusev\Parsedown\Parsing\Excerpt;
+
+interface BacktrackingInline extends Inline
+{
+    /**
+     * Return an integer to declare that the inline should be treated as if it
+     * started from that position in the excerpt given to static::build.
+     * Return null to use the excerpt offset value.
+     * @return int|null
+     * */
+    public function modifyStartPositionTo();
+}

src/Components/Block.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Erusev\Parsedown\Components;
+
+use Erusev\Parsedown\Component;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+interface Block extends Component
+{
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    );
+}

src/Components/Blocks/BlockQuote.php

@@ -0,0 +1,122 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\Parsing\Line;
+use Erusev\Parsedown\Parsing\Lines;
+use Erusev\Parsedown\State;
+
+final class BlockQuote implements ContinuableBlock
+{
+    /** @var Lines */
+    private $Lines;
+
+    /**
+     * @param Lines $Lines
+     */
+    private function __construct($Lines)
+    {
+        $this->Lines = $Lines;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if (\preg_match('/^(>[ \t]?+)(.*+)/', $Context->line()->text(), $matches)) {
+            $indentOffset = $Context->line()->indentOffset() + $Context->line()->indent() + \strlen($matches[1]);
+
+            $recoveredSpaces = 0;
+            if (\strlen($matches[1]) === 2 && \substr($matches[1], 1, 1) === "\t") {
+                $recoveredSpaces = Line::tabShortage(0, $indentOffset -1) -1;
+            }
+
+            return new self(Lines::fromTextLines(
+                \str_repeat(' ', $recoveredSpaces) . $matches[2],
+                $indentOffset
+            ));
+        }
+
+        return null;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        if ($Context->previousEmptyLines() > 0) {
+            return null;
+        }
+
+        if (\preg_match('/^(>[ \t]?+)(.*+)/', $Context->line()->text(), $matches)) {
+            $indentOffset = $Context->line()->indentOffset() + $Context->line()->indent() + \strlen($matches[1]);
+
+            $recoveredSpaces = 0;
+            if (\strlen($matches[1]) === 2 && \substr($matches[1], 1, 1) === "\t") {
+                $recoveredSpaces = Line::tabShortage(0, $indentOffset -1) -1;
+            }
+
+            $Lines = $this->Lines->appendingTextLines(
+                \str_repeat(' ', $recoveredSpaces) . $matches[2],
+                $indentOffset
+            );
+
+            return new self($Lines);
+        }
+
+        if (! $Context->previousEmptyLines() > 0) {
+            $indentOffset = $Context->line()->indentOffset() + $Context->line()->indent();
+            $Lines = $this->Lines->appendingTextLines($Context->line()->text(), $indentOffset);
+
+            return new self($Lines);
+        }
+
+        return null;
+    }
+
+    /**
+     * @return array{0: Block[], 1: State}
+     */
+    public function contents(State $State)
+    {
+        return Parsedown::blocks($this->Lines, $State);
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                list($Blocks, $State) = $this->contents($State);
+
+                $StateRenderables = Parsedown::stateRenderablesFrom($Blocks);
+
+                $Renderables = $State->applyTo($StateRenderables);
+                $Renderables[] = new Text("\n");
+
+                return new Element('blockquote', [], $Renderables);
+            }
+        );
+    }
+}

src/Components/Blocks/FencedCode.php

@@ -0,0 +1,150 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class FencedCode implements ContinuableBlock
+{
+    /** @var string */
+    private $code;
+
+    /** @var string */
+    private $infostring;
+
+    /** @var string */
+    private $marker;
+
+    /** @var int */
+    private $openerLength;
+
+    /** @var bool */
+    private $isComplete;
+
+    /**
+     * @param string $code
+     * @param string $infostring
+     * @param string $marker
+     * @param int $openerLength
+     * @param bool $isComplete
+     */
+    private function __construct($code, $infostring, $marker, $openerLength, $isComplete)
+    {
+        $this->code = $code;
+        $this->infostring = $infostring;
+        $this->marker = $marker;
+        $this->openerLength = $openerLength;
+        $this->isComplete = $isComplete;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        $marker = \substr($Context->line()->text(), 0, 1);
+
+        if ($marker !== '`' && $marker !== '~') {
+            return null;
+        }
+
+        $openerLength = \strspn($Context->line()->text(), $marker);
+
+        if ($openerLength < 3) {
+            return null;
+        }
+
+        $infostring = \trim(\substr($Context->line()->text(), $openerLength), "\t ");
+
+        if (\strpos($infostring, '`') !== false) {
+            return null;
+        }
+
+        return new self('', $infostring, $marker, $openerLength, false);
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        if ($this->isComplete) {
+            return null;
+        }
+
+        $newCode = $this->code;
+
+        $newCode .= $Context->previousEmptyLinesText();
+
+        if (($len = \strspn($Context->line()->text(), $this->marker)) >= $this->openerLength
+            && \chop(\substr($Context->line()->text(), $len), ' ') === ''
+        ) {
+            return new self($newCode, $this->infostring, $this->marker, $this->openerLength, true);
+        }
+
+        $newCode .= $Context->line()->rawLine() . "\n";
+
+        return new self($newCode, $this->infostring, $this->marker, $this->openerLength, false);
+    }
+
+    /** @return string */
+    public function infostring()
+    {
+        return $this->infostring;
+    }
+
+    /** @return string */
+    public function code()
+    {
+        return $this->code;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        /**
+         * https://www.w3.org/TR/2011/WD-html5-20110525/elements.html#classes
+         * Every HTML element may have a class attribute specified.
+         * The attribute, if specified, must have a value that is a set
+         * of space-separated tokens representing the various classes
+         * that the element belongs to.
+         * [...]
+         * The space characters, for the purposes of this specification,
+         * are U+0020 SPACE, U+0009 CHARACTER TABULATION (tab),
+         * U+000A LINE FEED (LF), U+000C FORM FEED (FF), and
+         * U+000D CARRIAGE RETURN (CR).
+         */
+        $infostring = \substr(
+            $this->infostring(),
+            0,
+            \strcspn($this->infostring(), " \t\n\f\r")
+        );
+
+        // only necessary pre-php7
+        if ($infostring === false) {
+            $infostring = '';
+        }
+
+        return new Element('pre', [], [new Element(
+            'code',
+            $infostring !== '' ? ['class' => "language-{$infostring}"] : [],
+            [new Text($this->code())]
+        )]);
+    }
+}

src/Components/Blocks/Header.php

@@ -0,0 +1,107 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Configurables\StrictMode;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class Header implements Block
+{
+    /** @var string */
+    private $text;
+
+    /** @var 1|2|3|4|5|6 */
+    private $level;
+
+    /**
+     * @param string $text
+     * @param 1|2|3|4|5|6 $level
+     */
+    private function __construct($text, $level)
+    {
+        $this->text = $text;
+        $this->level = $level;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if ($Context->line()->indent() > 3) {
+            return null;
+        }
+
+        $level = \strspn($Context->line()->text(), '#');
+
+        if ($level > 6 || $level < 1) {
+            return null;
+        }
+
+        /** @var 1|2|3|4|5|6 $level */
+
+        $text = \ltrim($Context->line()->text(), '#');
+
+        $firstChar = \substr($text, 0, 1);
+
+        if (
+            $State->get(StrictMode::class)->isEnabled()
+            && \trim($firstChar, " \t") !== ''
+        ) {
+            return null;
+        }
+
+        $text = \trim($text, " \t");
+
+        # remove closing sequence
+        $removedClosing = \rtrim($text, '#');
+        $lastChar = \substr($removedClosing, -1);
+
+        if (\trim($lastChar, " \t") === '') {
+            $text = \rtrim($removedClosing, " \t");
+        }
+
+        return new self($text, $level);
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /** @return 1|2|3|4|5|6 */
+    public function level()
+    {
+        return $this->level;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                return new Element(
+                    'h' . \strval($this->level()),
+                    [],
+                    $State->applyTo(Parsedown::line($this->text(), $State))
+                );
+            }
+        );
+    }
+}

src/Components/Blocks/IndentedCode.php

@@ -0,0 +1,94 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\Parsing\Line;
+use Erusev\Parsedown\State;
+
+final class IndentedCode implements ContinuableBlock
+{
+    /** @var string */
+    private $code;
+
+    /**
+     * @param string $code
+     */
+    private function __construct($code)
+    {
+        $this->code = $code;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if (isset($Block) && $Block instanceof Paragraph && ! $Context->previousEmptyLines() > 0) {
+            return null;
+        }
+
+        if ($Context->line()->indent() < 4) {
+            return null;
+        }
+
+        return new self($Context->line()->ltrimBodyUpto(4) . "\n");
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        if ($Context->line()->indent() < 4) {
+            return null;
+        }
+
+        $newCode = $this->code;
+
+        $offset = $Context->line()->indentOffset();
+
+        if ($Context->previousEmptyLines() > 0) {
+            foreach (\explode("\n", $Context->previousEmptyLinesText()) as $line) {
+                $newCode .= (new Line($line, $offset))->ltrimBodyUpto(4) . "\n";
+            }
+
+            $newCode = \substr($newCode, 0, -1);
+        }
+
+        $newCode .= $Context->line()->ltrimBodyUpto(4) . "\n";
+
+        return new self($newCode);
+    }
+
+    /** @return string */
+    public function code()
+    {
+        return $this->code;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return new Element(
+            'pre',
+            [],
+            [new Element('code', [], [new Text($this->code())])]
+        );
+    }
+}

src/Components/Blocks/Markup.php

@@ -0,0 +1,174 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Configurables\SafeMode;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\RawHtml;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class Markup implements ContinuableBlock
+{
+    const REGEX_HTML_ATTRIBUTE = '[a-zA-Z_:][\w:.-]*+(?:\s*+=\s*+(?:[^"\'=<>`\s]+|"[^"]*+"|\'[^\']*+\'))?+';
+
+    /** @var array{2: string, 3: string, 4: string, 5: string} */
+    private static $simpleContainsEndConditions = [
+        2 => '-->',
+        3 => '?>',
+        4 => '>',
+        5 => ']]>'
+    ];
+
+    /** @var array<string, string> */
+    private static $specialHtmlBlockTags = [
+        'script' => true,
+        'style' => true,
+        'pre' => true,
+    ];
+
+    /** @var string */
+    private $html;
+
+    /** @var 1|2|3|4|5|6|7 */
+    private $type;
+
+    /** @var bool */
+    private $closed;
+
+    /**
+     * @param string $html
+     * @param 1|2|3|4|5|6|7 $type
+     * @param bool $closed
+     */
+    private function __construct($html, $type, $closed = false)
+    {
+        $this->html = $html;
+        $this->type = $type;
+        $this->closed = $closed;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        $text = $Context->line()->text();
+        $rawLine = $Context->line()->rawLine();
+
+        if (\preg_match('/^<(?:script|pre|style)(?:\s++|>|$)/i', $text)) {
+            return new self($rawLine, 1, self::closes12345TypeMarkup(1, $text));
+        }
+
+        if (\substr($text, 0, 4) === '<!--') {
+            return new self($rawLine, 2, self::closes12345TypeMarkup(2, $text));
+        }
+
+        if (\substr($text, 0, 2) === '<?') {
+            return new self($rawLine, 3, self::closes12345TypeMarkup(3, $text));
+        }
+
+        if (\preg_match('/^<![A-Z]/', $text)) {
+            return new self($rawLine, 4, self::closes12345TypeMarkup(4, $text));
+        }
+
+        if (\substr($text, 0, 9) === '<![CDATA[') {
+            return new self($rawLine, 5, self::closes12345TypeMarkup(5, $text));
+        }
+
+        if (\preg_match('/^<[\/]?+(\w++)(?:[ ]*+'.self::REGEX_HTML_ATTRIBUTE.')*+[ ]*+(\/)?>/', $text, $matches)) {
+            $element = \strtolower($matches[1]);
+
+            if (
+                \array_key_exists($element, Element::$TEXT_LEVEL_ELEMENTS)
+                || \array_key_exists($element, self::$specialHtmlBlockTags)
+            ) {
+                return null;
+            }
+
+            return new self($rawLine, 6);
+        }
+
+        return null;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        $closed = $this->closed;
+        $type = $this->type;
+
+        if ($closed) {
+            return null;
+        }
+
+        if (($type === 6 || $type === 7) && $Context->previousEmptyLines() > 0) {
+            return null;
+        }
+
+        if ($type === 1 || $type === 2 || $type === 3 || $type === 4 || $type === 5) {
+            $closed = self::closes12345TypeMarkup($type, $Context->line()->text());
+        }
+
+        $html = $this->html . \str_repeat("\n", $Context->previousEmptyLines() + 1);
+        $html .= $Context->line()->rawLine();
+
+        return new self($html, $type, $closed);
+    }
+
+    /**
+     * @param 1|2|3|4|5 $type
+     * @param string $text
+     * @return bool
+     */
+    private static function closes12345TypeMarkup($type, $text)
+    {
+        if ($type === 1) {
+            if (\preg_match('/<\/(?:script|pre|style)>/i', $text)) {
+                return true;
+            }
+        } elseif (\stripos($text, self::$simpleContainsEndConditions[$type]) !== false) {
+            return true;
+        }
+
+        return false;
+    }
+
+    /** @return string */
+    public function html()
+    {
+        return $this->html;
+    }
+
+    /**
+     * @return Handler<Element|RawHtml>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element|RawHtml */
+            function (State $State) {
+                if ($State->get(SafeMode::class)->isEnabled()) {
+                    return new Element('p', [], [new Text($this->html())]);
+                } else {
+                    return new RawHtml($this->html());
+                }
+            }
+        );
+    }
+}

src/Components/Blocks/Paragraph.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class Paragraph implements ContinuableBlock
+{
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $text
+     */
+    private function __construct($text)
+    {
+        $this->text = $text;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        return new self($Context->line()->text());
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        if ($Context->previousEmptyLines() > 0) {
+            return null;
+        }
+
+        return new self($this->text . "\n" . $Context->line()->text());
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                return new Element(
+                    'p',
+                    [],
+                    $State->applyTo(Parsedown::line(\trim($this->text()), $State))
+                );
+            }
+        );
+    }
+}

src/Components/Blocks/Reference.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\StateUpdatingBlock;
+use Erusev\Parsedown\Configurables\DefinitionBook;
+use Erusev\Parsedown\Html\Renderables\Invisible;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class Reference implements StateUpdatingBlock
+{
+    /** @var State */
+    private $State;
+
+    private function __construct(State $State)
+    {
+        $this->State = $State;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if (\preg_match(
+            '/^\[(.+?)\]:[ ]*+<?(\S+?)>?(?:[ ]+["\'(](.+)["\')])?[ ]*+$/',
+            $Context->line()->text(),
+            $matches
+        )) {
+            $id = \strtolower($matches[1]);
+
+            $Data = [
+                'url' => $matches[2],
+                'title' => isset($matches[3]) ? $matches[3] : null,
+            ];
+
+            $State = $State->setting(
+                $State->get(DefinitionBook::class)->setting($id, $Data)
+            );
+
+            return new self($State);
+        }
+
+        return null;
+    }
+
+    /** @return State */
+    public function latestState()
+    {
+        return $this->State;
+    }
+
+    /**
+     * @return Invisible
+     */
+    public function stateRenderable()
+    {
+        return new Invisible;
+    }
+}

src/Components/Blocks/Rule.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class Rule implements Block
+{
+    private function __construct()
+    {
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if ($Context->line()->indent() > 3) {
+            return null;
+        }
+
+        $marker = \substr($Context->line()->text(), 0, 1);
+
+        if ($marker !== '*' && $marker !== '-' && $marker !== '_') {
+            return null;
+        }
+
+        if (
+            \substr_count($Context->line()->text(), $marker) >= 3
+            && \chop($Context->line()->text(), " \t$marker") === ''
+        ) {
+            return new self;
+        }
+
+        return null;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return Element::selfClosing('hr', []);
+    }
+}

src/Components/Blocks/SetextHeader.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\AcquisitioningBlock;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+final class SetextHeader implements AcquisitioningBlock
+{
+    /** @var string */
+    private $text;
+
+    /** @var 1|2 */
+    private $level;
+
+    /**
+     * @param string $text
+     * @param 1|2 $level
+     */
+    private function __construct($text, $level)
+    {
+        $this->text = $text;
+        $this->level = $level;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if (! isset($Block) || ! $Block instanceof Paragraph || $Context->previousEmptyLines() > 0) {
+            return null;
+        }
+
+        $marker = \substr($Context->line()->text(), 0, 1);
+
+        if ($marker !== '=' && $marker !== '-') {
+            return null;
+        }
+
+        if (
+            $Context->line()->indent() < 4
+            && \chop(\chop($Context->line()->text(), " \t"), $marker) === ''
+        ) {
+            $level = ($marker === '=' ? 1 : 2);
+
+            return new self(\trim($Block->text()), $level);
+        }
+
+        return null;
+    }
+
+    /** @return bool */
+    public function acquiredPrevious()
+    {
+        return true;
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /** @return 1|2 */
+    public function level()
+    {
+        return $this->level;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                return new Element(
+                    'h' . \strval($this->level()),
+                    [],
+                    $State->applyTo(Parsedown::line($this->text(), $State))
+                );
+            }
+        );
+    }
+}

src/Components/Blocks/TList.php

@@ -0,0 +1,347 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\Parsing\Line;
+use Erusev\Parsedown\Parsing\Lines;
+use Erusev\Parsedown\State;
+
+final class TList implements ContinuableBlock
+{
+    /** @var Lines[] */
+    private $Lis;
+
+    /** @var int|null */
+    private $listStart;
+
+    /** @var bool */
+    private $isLoose;
+
+    /** @var int */
+    private $indent;
+
+    /** @var 'ul'|'ol' */
+    private $type;
+
+    /** @var string */
+    private $marker;
+
+    /** @var int */
+    private $afterMarkerSpaces;
+
+    /** @var string */
+    private $markerType;
+
+    /** @var string */
+    private $markerTypeRegex;
+
+    /**
+     * @param Lines[] $Lis
+     * @param int|null $listStart
+     * @param bool $isLoose
+     * @param int $indent
+     * @param 'ul'|'ol' $type
+     * @param string $marker
+     * @param int $afterMarkerSpaces
+     * @param string $markerType
+     * @param string $markerTypeRegex
+     */
+    private function __construct(
+        $Lis,
+        $listStart,
+        $isLoose,
+        $indent,
+        $type,
+        $marker,
+        $afterMarkerSpaces,
+        $markerType,
+        $markerTypeRegex
+    ) {
+        $this->Lis = $Lis;
+        $this->listStart = $listStart;
+        $this->isLoose = $isLoose;
+        $this->indent = $indent;
+        $this->type = $type;
+        $this->marker = $marker;
+        $this->afterMarkerSpaces = $afterMarkerSpaces;
+        $this->markerType = $markerType;
+        $this->markerTypeRegex = $markerTypeRegex;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        list($type, $pattern) = (
+            \substr($Context->line()->text(), 0, 1) <= '-'
+            ? ['ul', '[*+-]']
+            : ['ol', '[0-9]{1,9}+[.\)]']
+        );
+
+        if (\preg_match(
+            '/^('.$pattern.')([\t ]++.*|$)/',
+            $Context->line()->text(),
+            $matches
+        )) {
+            $marker = $matches[1];
+
+            $preAfterMarkerSpacesIndentOffset = $Context->line()->indentOffset() + $Context->line()->indent() + \strlen($marker);
+
+            $LineWithMarkerIndent = new Line(isset($matches[2]) ? $matches[2] : '', $preAfterMarkerSpacesIndentOffset);
+            $indentAfterMarker = $LineWithMarkerIndent->indent();
+
+            if ($indentAfterMarker > 4) {
+                $perceivedIndent = $indentAfterMarker -1;
+                $afterMarkerSpaces = 1;
+            } else {
+                $perceivedIndent = 0;
+                $afterMarkerSpaces = $indentAfterMarker;
+            }
+
+            $indentOffset = $preAfterMarkerSpacesIndentOffset + $afterMarkerSpaces;
+            $text = \str_repeat(' ', $perceivedIndent) . $LineWithMarkerIndent->text();
+
+            $markerType = (
+                $type === 'ul'
+                ? $marker
+                : \substr($marker, -1)
+            );
+
+            $markerTypeRegex = \preg_quote($markerType, '/');
+
+            /** @var int|null */
+            $listStart = null;
+
+            if ($type === 'ol') {
+                /** @psalm-suppress PossiblyFalseArgument */
+                $listStart = \intval(\strstr($matches[1], $markerType, true) ?: '0');
+
+                if (
+                    $listStart !== 1
+                    && isset($Block)
+                    && $Block instanceof Paragraph
+                    && ! $Context->previousEmptyLines() > 0
+                ) {
+                    return null;
+                }
+            }
+
+            return new self(
+                [!empty($text) ? Lines::fromTextLines($text, $indentOffset) : Lines::none()],
+                $listStart,
+                false,
+                $Context->line()->indent(),
+                $type,
+                $marker,
+                $afterMarkerSpaces,
+                $markerType,
+                $markerTypeRegex
+            );
+        }
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        if ($Context->previousEmptyLines() > 0 && \end($this->Lis)->isEmpty()) {
+            return null;
+        }
+
+        $newlines = \str_repeat("\n", $Context->previousEmptyLines());
+
+        $requiredIndent = $this->indent + \strlen($this->marker) + $this->afterMarkerSpaces;
+        $isLoose = $this->isLoose;
+        $indent = $Context->line()->indent();
+
+        $Lis = $this->Lis;
+
+        if ($Context->line()->indent() < $requiredIndent
+            && ((
+                $this->type === 'ol'
+                && \preg_match('/^([0-9]++'.$this->markerTypeRegex.')([\t ]++.*|$)/', $Context->line()->text(), $matches)
+            ) || (
+                $this->type === 'ul'
+                && \preg_match('/^('.$this->markerTypeRegex.')([\t ]++.*|$)/', $Context->line()->text(), $matches)
+            ))
+        ) {
+            if ($Context->previousEmptyLines() > 0) {
+                $Lis[\count($Lis) -1] = $Lis[\count($Lis) -1]->appendingBlankLines(1);
+
+                $isLoose = true;
+            }
+
+            $marker = $matches[1];
+
+            $preAfterMarkerSpacesIndentOffset = $Context->line()->indentOffset() + $Context->line()->indent() + \strlen($marker);
+
+            $LineWithMarkerIndent = new Line(isset($matches[2]) ? $matches[2] : '', $preAfterMarkerSpacesIndentOffset);
+            $indentAfterMarker = $LineWithMarkerIndent->indent();
+
+            if ($indentAfterMarker > 4) {
+                $perceivedIndent = $indentAfterMarker -1;
+                $afterMarkerSpaces = 1;
+            } else {
+                $perceivedIndent = 0;
+                $afterMarkerSpaces = $indentAfterMarker;
+            }
+
+            $indentOffset = $preAfterMarkerSpacesIndentOffset + $afterMarkerSpaces;
+            $text = \str_repeat(' ', $perceivedIndent) . $LineWithMarkerIndent->text();
+
+            $Lis[] = Lines::fromTextLines($newlines . $text, $indentOffset);
+
+            return new self(
+                $Lis,
+                $this->listStart,
+                $isLoose,
+                $indent,
+                $this->type,
+                $marker,
+                $afterMarkerSpaces,
+                $this->markerType,
+                $this->markerTypeRegex
+            );
+        } elseif ($Context->line()->indent() < $requiredIndent && self::build($Context, $State) !== null) {
+            return null;
+        }
+
+        if ($Context->line()->indent() >= $requiredIndent) {
+            if ($Context->previousEmptyLines() > 0) {
+                $Lis[\count($Lis) -1] = $Lis[\count($Lis) -1]->appendingBlankLines($Context->previousEmptyLines());
+
+                $isLoose = true;
+            }
+
+            $text = $Context->line()->ltrimBodyUpto($requiredIndent);
+            $indentOffset = $Context->line()->indentOffset() + \min($requiredIndent, $Context->line()->indent());
+
+            $Lis[\count($Lis) -1] = $Lis[\count($Lis) -1]->appendingTextLines($text, $indentOffset);
+
+            return new self(
+                $Lis,
+                $this->listStart,
+                $isLoose,
+                $this->indent,
+                $this->type,
+                $this->marker,
+                $this->afterMarkerSpaces,
+                $this->markerType,
+                $this->markerTypeRegex
+            );
+        }
+
+        if (! $Context->previousEmptyLines() > 0) {
+            $text = $Context->line()->ltrimBodyUpto($requiredIndent);
+
+            $Lis[\count($Lis) -1] = $Lis[\count($Lis) -1]->appendingTextLines(
+                $newlines . \str_repeat(' ', $Context->line()->indent()) . $text,
+                $Context->line()->indentOffset() + \min($requiredIndent, $Context->line()->indent())
+            );
+
+            return new self(
+                $Lis,
+                $this->listStart,
+                $isLoose,
+                $this->indent,
+                $this->type,
+                $this->marker,
+                $this->afterMarkerSpaces,
+                $this->markerType,
+                $this->markerTypeRegex
+            );
+        }
+
+        return null;
+    }
+
+    /**
+     * @return array{0: Block[], 1: State}[]
+     */
+    public function items(State $State)
+    {
+        return \array_map(
+            /** @return array{0: Block[], 1: State} */
+            function (Lines $Lines) use ($State) {
+                return Parsedown::blocks($Lines, $State);
+            },
+            $this->Lis
+        );
+    }
+
+    /** @return 'ol'|'ul' */
+    public function type()
+    {
+        return $this->type;
+    }
+
+    /** @return int|null */
+    public function listStart()
+    {
+        return $this->listStart;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                $listStart = $this->listStart();
+
+                return new Element(
+                    $this->type(),
+                    (
+                        isset($listStart) && $listStart !== 1
+                        ? ['start' => \strval($listStart)]
+                        : []
+                    ),
+                    \array_map(
+                        /**
+                         * @param array{0: Block[], 1: State} $Item
+                         * @return Element
+                         * */
+                        function ($Item) {
+                            list($Blocks, $State) = $Item;
+
+                            $StateRenderables = Parsedown::stateRenderablesFrom($Blocks);
+                            $Renderables = $State->applyTo($StateRenderables);
+
+                            if (! $this->isLoose
+                                && isset($Renderables[0])
+                                && $Renderables[0] instanceof Element
+                                && $Renderables[0]->name() === 'p'
+                            ) {
+                                $Contents = $Renderables[0]->contents();
+                                unset($Renderables[0]);
+                                $Renderables = \array_merge($Contents ?: [], $Renderables);
+                            }
+
+                            return new Element('li', [], $Renderables);
+                        },
+                        $this->items($State)
+                    )
+                );
+            }
+        );
+    }
+}

src/Components/Blocks/Table.php

@@ -0,0 +1,277 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Blocks;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\AcquisitioningBlock;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+/**
+ * @psalm-type _Alignment='left'|'center'|'right'
+ */
+final class Table implements AcquisitioningBlock, ContinuableBlock
+{
+    /** @var bool */
+    private $acquired;
+
+    /** @var array<int, _Alignment|null> */
+    private $alignments;
+
+    /** @var array<int, string> */
+    private $headerCells;
+
+    /** @var array<int, array<int, string>> */
+    private $rows;
+
+    /**
+     * @param array<int, _Alignment|null> $alignments
+     * @param array<int, string> $headerCells
+     * @param array<int, array<int, string>> $rows
+     * @param bool $acquired
+     */
+    private function __construct($alignments, $headerCells, $rows, $acquired = false)
+    {
+        $this->alignments = $alignments;
+        $this->headerCells = $headerCells;
+        $this->rows = $rows;
+        $this->acquired = $acquired;
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @param Block|null $Block
+     * @return static|null
+     */
+    public static function build(
+        Context $Context,
+        State $State,
+        Block $Block = null
+    ) {
+        if (! isset($Block) || ! $Block instanceof Paragraph) {
+            return null;
+        }
+
+        if (
+            \strpos($Block->text(), '|') === false
+            && \strpos($Context->line()->text(), '|') === false
+            && \strpos($Context->line()->text(), ':') === false
+            || \strpos($Block->text(), "\n") !== false
+        ) {
+            return null;
+        }
+
+        if (\chop($Context->line()->text(), ' -:|') !== '') {
+            return null;
+        }
+
+
+        $alignments = self::parseAlignments($Context->line()->text());
+
+        if (! isset($alignments)) {
+            return null;
+        }
+
+        # ~
+
+        $headerRow = \trim(\trim($Block->text()), '|');
+
+        $headerCells = \array_map('trim', \explode('|', $headerRow));
+
+        if (\count($headerCells) !== \count($alignments)) {
+            return null;
+        }
+
+        # ~
+
+        return new self($alignments, $headerCells, [], true);
+    }
+
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return self|null
+     */
+    public function advance(Context $Context, State $State)
+    {
+        if ($Context->previousEmptyLines() > 0) {
+            return null;
+        }
+
+        if (
+            \count($this->alignments) !== 1
+            && \strpos($Context->line()->text(), '|') === false
+        ) {
+            return null;
+        }
+
+        $row = \trim(\trim($Context->line()->text()), '|');
+
+        if (
+            ! \preg_match_all('/(?:(\\\\[|])|[^|`]|`[^`]++`|`)++/', $row, $matches)
+            || ! isset($matches[0])
+            || ! \is_array($matches[0])
+        ) {
+            return null;
+        }
+
+        $cells = \array_map('trim', \array_slice($matches[0], 0, \count($this->alignments)));
+
+        return new self(
+            $this->alignments,
+            $this->headerCells,
+            \array_merge($this->rows, [$cells])
+        );
+    }
+
+    /**
+     * @param string $dividerRow
+     * @return array<int, _Alignment|null>|null
+     */
+    private static function parseAlignments($dividerRow)
+    {
+        $dividerRow = \trim($dividerRow);
+        $dividerRow = \trim($dividerRow, '|');
+
+        $dividerCells = \explode('|', $dividerRow);
+
+        /** @var array<int, _Alignment|null> */
+        $alignments = [];
+
+        foreach ($dividerCells as $dividerCell) {
+            $dividerCell = \trim($dividerCell);
+
+            if ($dividerCell === '') {
+                return null;
+            }
+
+            /** @var _Alignment|null */
+            $alignment = null;
+
+            if (\substr($dividerCell, 0, 1) === ':') {
+                $alignment = 'left';
+            }
+
+            if (\substr($dividerCell, - 1) === ':') {
+                $alignment = $alignment === 'left' ? 'center' : 'right';
+            }
+
+            $alignments []= $alignment;
+        }
+
+        return $alignments;
+    }
+
+    /** @return bool */
+    public function acquiredPrevious()
+    {
+        return true;
+    }
+
+    /** @return array<int, Inline[]> */
+    public function headerRow(State $State)
+    {
+        return \array_map(
+            /**
+             * @param string $cell
+             * @return Inline[]
+             */
+            function ($cell) use ($State) {
+                return Parsedown::inlines($cell, $State);
+            },
+            $this->headerCells
+        );
+    }
+
+    /** @return array<int, Inline[]>[] */
+    public function rows(State $State)
+    {
+        return \array_map(
+            /**
+             * @param array<int, string> $cells
+             * @return array<int, Inline[]>
+             */
+            function ($cells) use ($State) {
+                return \array_map(
+                    /**
+                     * @param string $cell
+                     * @return Inline[]
+                     */
+                    function ($cell) use ($State) {
+                        return Parsedown::inlines($cell, $State);
+                    },
+                    $cells
+                );
+            },
+            $this->rows
+        );
+    }
+
+    /** @return array<int, _Alignment|null> */
+    public function alignments()
+    {
+        return $this->alignments;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                return new Element('table', [], [
+                    new Element('thead', [], [new Element('tr', [], \array_map(
+                        /**
+                         * @param Inline[] $Cell
+                         * @param _Alignment|null $alignment
+                         * @return Element
+                         */
+                        function ($Cell, $alignment) use ($State) {
+                            return new Element(
+                                'th',
+                                isset($alignment) ? ['style' => "text-align: $alignment;"] : [],
+                                $State->applyTo(Parsedown::stateRenderablesFrom($Cell))
+                            );
+                        },
+                        $this->headerRow($State),
+                        $this->alignments()
+                    ))]),
+                    new Element('tbody', [], \array_map(
+                        /**
+                         * @param Inline[][] $Cells
+                         * @return Element
+                         */
+                        function ($Cells) use ($State) {
+                            return new Element('tr', [], \array_map(
+                                /**
+                                 * @param Inline[] $Cell
+                                 * @param _Alignment|null $alignment
+                                 * @return Element
+                                 */
+                                function ($Cell, $alignment) use ($State) {
+                                    return new Element(
+                                        'td',
+                                        isset($alignment) ? ['style' => "text-align: $alignment;"] : [],
+                                        $State->applyTo(Parsedown::stateRenderablesFrom($Cell))
+                                    );
+                                },
+                                $Cells,
+                                \array_slice($this->alignments(), 0, \count($Cells))
+                            ));
+                        },
+                        $this->rows($State)
+                    ))
+                ]);
+            }
+        );
+    }
+}

src/Components/ContinuableBlock.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Erusev\Parsedown\Components;
+
+use Erusev\Parsedown\Parsing\Context;
+use Erusev\Parsedown\State;
+
+interface ContinuableBlock extends Block
+{
+    /**
+     * @param Context $Context
+     * @param State $State
+     * @return static|null
+     */
+    public function advance(Context $Context, State $State);
+}

src/Components/Inline.php

@@ -0,0 +1,29 @@
+<?php
+
+namespace Erusev\Parsedown\Components;
+
+use Erusev\Parsedown\Component;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+interface Inline extends Component
+{
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State);
+
+    /**
+     * Number of characters consumed by the build action.
+     * @return int
+     * */
+    public function width();
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext();
+}

src/Components/Inlines/Code.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class Code implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $text
+     * @param int $width
+     */
+    private function __construct($text, $width)
+    {
+        $this->text = $text;
+        $this->width = $width;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $marker = \substr($Excerpt->text(), 0, 1);
+
+        if ($marker !== '`') {
+            return null;
+        }
+
+        if (\preg_match(
+            '/^(['.$marker.']++)(.*?)(?<!['.$marker.'])\1(?!'.$marker.')/s',
+            $Excerpt->text(),
+            $matches
+        )) {
+            $text = \str_replace("\n", ' ', $matches[2]);
+
+            $firstChar = \substr($text, 0, 1);
+            $lastChar = \substr($text, -1);
+
+            if ($firstChar === ' ' && $lastChar === ' ') {
+                $text = \substr(\substr($text, 1), 0, -1);
+            }
+
+            return new self($text, \strlen($matches[0]));
+        }
+
+        return null;
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return new Element('code', [], [new Text($this->text())]);
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->text());
+    }
+}

src/Components/Inlines/Email.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class Email implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $text;
+
+    /** @var string */
+    private $url;
+
+    /**
+     * @param string $text
+     * @param string $url
+     * @param int $width
+     */
+    private function __construct($text, $url, $width)
+    {
+        $this->text = $text;
+        $this->url = $url;
+        $this->width = $width;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $hostnameLabel = '[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?';
+
+        $commonMarkEmail = '[a-zA-Z0-9.!#$%&\'*+\/=?^_`{|}~-]++@'
+            . $hostnameLabel . '(?:\.' . $hostnameLabel . ')*';
+
+        if (\preg_match("/^<((mailto:)?$commonMarkEmail)>/i", $Excerpt->text(), $matches)) {
+            $url = $matches[1];
+
+            if (! isset($matches[2])) {
+                $url = "mailto:$url";
+            }
+
+            return new self($matches[1], $url, \strlen($matches[0]));
+        }
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /** @return string */
+    public function url()
+    {
+        return $this->url;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return new Element('a', ['href' => $this->url()], [new Text($this->text())]);
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->text());
+    }
+}

src/Components/Inlines/Emphasis.php

@@ -0,0 +1,102 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class Emphasis implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $text;
+
+    /** @var 'em'|'strong' */
+    private $type;
+
+    /** @var array{*: string, _: string} */
+    private static $STRONG_REGEX = [
+        '*' => '/^[*]{2}((?:\\\\\*|[^*]|[*][^*]*+[*])+?)[*]{2}(?![*])/s',
+        '_' => '/^__((?:\\\\_|[^_]|_[^_]*+_)+?)__(?!_)/us',
+    ];
+
+    /** @var array{*: string, _: string} */
+    private static $EM_REGEX = [
+        '*' => '/^[*]((?:\\\\\*|[^*]|[*][*][^*]+?[*][*])+?)[*](?![*])/s',
+        '_' => '/^_((?:\\\\_|[^_]|__[^_]*__)+?)_(?!_)\b/us',
+    ];
+
+    /**
+     * @param string $text
+     * @param 'em'|'strong' $type
+     * @param int $width
+     */
+    private function __construct($text, $type, $width)
+    {
+        $this->text = $text;
+        $this->type = $type;
+        $this->width = $width;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $marker = \substr($Excerpt->text(), 0, 1);
+
+        if ($marker !== '*' && $marker !== '_') {
+            return null;
+        }
+
+        if (\preg_match(self::$STRONG_REGEX[$marker], $Excerpt->text(), $matches)) {
+            $emphasis = 'strong';
+        } elseif (\preg_match(self::$EM_REGEX[$marker], $Excerpt->text(), $matches)) {
+            $emphasis = 'em';
+        } else {
+            return null;
+        }
+
+        return new self($matches[1], $emphasis, \strlen($matches[0]));
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                return new Element(
+                    $this->type,
+                    [],
+                    $State->applyTo(Parsedown::line($this->text(), $State))
+                );
+            }
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->text());
+    }
+}

src/Components/Inlines/EscapeSequence.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class EscapeSequence implements Inline
+{
+    use WidthTrait;
+
+    const SPECIALS = '!"#$%&\'()*+,-./:;<=>?@[\]^_`{|}~';
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $text
+     */
+    private function __construct($text)
+    {
+        $this->text = $text;
+        $this->width = 2;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $char = \substr($Excerpt->text(), 1, 1);
+
+        if ($char !== '' && \strpbrk($char, self::SPECIALS) !== false) {
+            return new self($char);
+        }
+
+        return null;
+    }
+
+    /** @return string */
+    public function char()
+    {
+        return $this->text;
+    }
+
+    /**
+     * @return Text
+     */
+    public function stateRenderable()
+    {
+        return new Text($this->char());
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->char());
+    }
+}

src/Components/Inlines/HardBreak.php

@@ -0,0 +1,88 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\BacktrackingInline;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class HardBreak implements BacktrackingInline
+{
+    use WidthTrait;
+
+    /** @var int */
+    private $position;
+
+    /**
+     * @param int $width
+     * @param int $position
+     */
+    private function __construct($width, $position)
+    {
+        $this->width = $width;
+        $this->position = $position;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $marker = \substr($Excerpt->text(), 0, 1);
+
+        if ($marker !== "\n") {
+            return null;
+        }
+
+        $context = $Excerpt->context();
+        $offset = $Excerpt->offset();
+
+        if (\substr($context, $offset -1, 1) === '\\') {
+            $contentLen = $offset -1;
+
+            return new self($offset - $contentLen, $contentLen);
+        }
+
+        if (\substr($context, $offset -2, 2) === '  ') {
+            $trimTrailingWhitespace = \rtrim(\substr($context, 0, $offset));
+            $contentLen = \strlen($trimTrailingWhitespace);
+
+            return new self($offset - $contentLen, $contentLen);
+        }
+
+        return null;
+    }
+
+    /**
+     * Return an integer to declare that the inline should be treated as if it
+     * started from that position in the excerpt given to static::build.
+     * Return null to use the excerpt offset value.
+     * @return int|null
+     * */
+    public function modifyStartPositionTo()
+    {
+        return $this->position;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return Element::selfClosing('br', []);
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text("\n");
+    }
+}

src/Components/Inlines/Image.php

@@ -0,0 +1,121 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Configurables\SafeMode;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Html\Sanitisation\UrlSanitiser;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+/** @psalm-type _Metadata=array{href: string, title?: string} */
+final class Image implements Inline
+{
+    use WidthTrait;
+
+    /** @var Link */
+    private $Link;
+
+    /**
+     * @param Link $Link
+     */
+    private function __construct(Link $Link)
+    {
+        $this->Link = $Link;
+        $this->width = $Link->width() + 1;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        if (\substr($Excerpt->text(), 0, 1) !== '!') {
+            return null;
+        }
+
+        $Excerpt = $Excerpt->addingToOffset(1);
+
+        $Link = Link::build($Excerpt, $State);
+
+        if (! isset($Link)) {
+            return null;
+        }
+
+        return new self($Link);
+    }
+
+    /** @return string */
+    public function label()
+    {
+        return $this->Link->label();
+    }
+
+    /** @return string */
+    public function url()
+    {
+        return $this->Link->url();
+    }
+
+    /** @return string|null */
+    public function title()
+    {
+        return $this->Link->title();
+    }
+
+    /**
+     * @return Handler<Element|Text>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element|Text */
+            function (State $State) {
+                $attributes = [
+                    'src' => $this->url(),
+                    'alt' => \array_reduce(
+                        Parsedown::inlines($this->label(), $State),
+                        /**
+                         * @param string $text
+                         * @return string
+                         */
+                        function ($text, Inline $Inline) {
+                            return (
+                                $text
+                                . $Inline->bestPlaintext()->getStringBacking()
+                            );
+                        },
+                        ''
+                    ),
+                ];
+
+                $title = $this->title();
+
+                if (isset($title)) {
+                    $attributes['title'] = $title;
+                }
+
+                if ($State->get(SafeMode::class)->isEnabled()) {
+                    $attributes['src'] = UrlSanitiser::filter($attributes['src']);
+                }
+
+                return Element::selfClosing('img', $attributes);
+            }
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->label());
+    }
+}

src/Components/Inlines/Link.php

@@ -0,0 +1,155 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Configurables\DefinitionBook;
+use Erusev\Parsedown\Configurables\InlineTypes;
+use Erusev\Parsedown\Configurables\SafeMode;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Html\Sanitisation\UrlSanitiser;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+/** @psalm-type _Metadata=array{href: string, title?: string} */
+final class Link implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $label;
+
+    /** @var string */
+    private $url;
+
+    /** @var string|null */
+    private $title;
+
+    /**
+     * @param string $label
+     * @param string $url
+     * @param string|null $title
+     * @param int $width
+     */
+    private function __construct($label, $url, $title, $width)
+    {
+        $this->label = $label;
+        $this->url = $url;
+        $this->title = $title;
+        $this->width = $width;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $remainder = $Excerpt->text();
+
+        if (! \preg_match('/\[((?:[^][]++|(?R))*+)\]/', $remainder, $matches)) {
+            return null;
+        }
+
+        $label = $matches[1];
+
+        $width = \strlen($matches[0]);
+
+        $remainder = \substr($remainder, $width);
+
+        if (\preg_match('/^[(]\s*+(?:((?:[^ ()]++|[(][^ )]+[)])++)(?:[ ]+("[^"]*+"|\'[^\']*+\'))?\s*+)?[)]/', $remainder, $matches)) {
+            $url = isset($matches[1]) ? $matches[1] : '';
+            $title = isset($matches[2]) ? \substr($matches[2], 1, - 1) : null;
+
+            $width += \strlen($matches[0]);
+
+            return new self($label, $url, $title, $width);
+        } else {
+            if (\preg_match('/^\s*\[(.*?)\]/', $remainder, $matches)) {
+                $definition = \strlen($matches[1]) ? $matches[1] : $label;
+                $definition = \strtolower($definition);
+
+                $width += \strlen($matches[0]);
+            } else {
+                $definition = \strtolower($label);
+            }
+
+            $definition = \preg_replace('/\s++/', ' ', \trim($definition));
+
+            $data = $State->get(DefinitionBook::class)->lookup($definition);
+
+            if (! isset($data)) {
+                return null;
+            }
+
+            $url = $data['url'];
+            $title = isset($data['title']) ? $data['title'] : null;
+
+            return new self($label, $url, $title, $width);
+        }
+    }
+
+    /** @return string */
+    public function label()
+    {
+        return $this->label;
+    }
+
+    /** @return string */
+    public function url()
+    {
+        return $this->url;
+    }
+
+    /** @return string|null */
+    public function title()
+    {
+        return $this->title;
+    }
+
+    /**
+     * @return Handler<Element|Text>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element|Text */
+            function (State $State) {
+                $attributes = ['href' => $this->url()];
+
+                $title = $this->title();
+
+                if (isset($title)) {
+                    $attributes['title'] = $title;
+                }
+
+                if ($State->get(SafeMode::class)->isEnabled()) {
+                    $attributes['href'] = UrlSanitiser::filter($attributes['href']);
+                }
+
+                $State = $State->setting(
+                    $State->get(InlineTypes::class)->removing([Url::class])
+                );
+
+                return new Element(
+                    'a',
+                    $attributes,
+                    $State->applyTo(Parsedown::line($this->label(), $State))
+                );
+            }
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->label());
+    }
+}

src/Components/Inlines/Markup.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Configurables\SafeMode;
+use Erusev\Parsedown\Html\Renderables\RawHtml;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class Markup implements Inline
+{
+    use WidthTrait;
+
+    const HTML_ATT_REGEX = '[a-zA-Z_:][\w:.-]*+(?:\s*+=\s*+(?:[^"\'=<>`\s]+|"[^"]*+"|\'[^\']*+\'))?+';
+
+    /** @var string */
+    private $html;
+
+    /**
+     * @param string $html
+     */
+    private function __construct($html)
+    {
+        $this->html = $html;
+        $this->width = \strlen($html);
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $secondChar = \substr($Excerpt->text(), 1, 1);
+
+        if ($secondChar === '/' && \preg_match('/^<\/\w[\w-]*+[ ]*+>/s', $Excerpt->text(), $matches)) {
+            return new self($matches[0]);
+        }
+
+        if ($secondChar === '!' && \preg_match('/^<!---?[^>-](?:-?+[^-])*-->/s', $Excerpt->text(), $matches)) {
+            return new self($matches[0]);
+        }
+
+        if ($secondChar !== ' ' && \preg_match('/^<\w[\w-]*+(?:[ ]*+'.self::HTML_ATT_REGEX.')*+[ ]*+\/?>/s', $Excerpt->text(), $matches)) {
+            return new self($matches[0]);
+        }
+    }
+
+    /** @return string */
+    public function html()
+    {
+        return $this->html;
+    }
+
+    /**
+     * @return Handler<Text|RawHtml>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Text|RawHtml */
+            function (State $State) {
+                if ($State->get(SafeMode::class)->isEnabled()) {
+                    return new Text($this->html());
+                } else {
+                    return new RawHtml($this->html());
+                }
+            }
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->html());
+    }
+}

src/Components/Inlines/PlainText.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class PlainText implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $text
+     */
+    private function __construct($text)
+    {
+        $this->text = $text;
+        $this->width = \strlen($text);
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        return new self($Excerpt->text());
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /**
+     * @return Text
+     */
+    public function stateRenderable()
+    {
+        return new Text($this->text());
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->text());
+    }
+}

src/Components/Inlines/SoftBreak.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\BacktrackingInline;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Configurables\Breaks;
+use Erusev\Parsedown\Html\Renderables\Container;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class SoftBreak implements BacktrackingInline
+{
+    use WidthTrait;
+
+    /** @var int */
+    private $position;
+
+    /**
+     * @param int $width
+     * @param int $position
+     */
+    private function __construct($width, $position)
+    {
+        $this->width = $width;
+        $this->position = $position;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $marker = \substr($Excerpt->text(), 0, 1);
+
+        if ($marker !== "\n") {
+            return null;
+        }
+
+        $context = $Excerpt->context();
+        $offset = $Excerpt->offset();
+
+        $trimTrailingWhitespaceBefore = \rtrim(\substr($context, 0, $offset), ' ');
+        $trimLeadingWhitespaceAfter = \ltrim(\substr($context, $offset + 1), ' ');
+        $contentLenBefore = \strlen($trimTrailingWhitespaceBefore);
+        $contentLenAfter = \strlen($trimLeadingWhitespaceAfter);
+
+        $originalLen = \strlen($context);
+        $afterWidth = $originalLen - $offset - $contentLenAfter;
+
+        return new self($offset + $afterWidth - $contentLenBefore, $contentLenBefore);
+    }
+
+    /**
+     * Return an integer to declare that the inline should be treated as if it
+     * started from that position in the excerpt given to static::build.
+     * Return null to use the excerpt offset value.
+     * @return int|null
+     * */
+    public function modifyStartPositionTo()
+    {
+        return $this->position;
+    }
+
+    /**
+     * @return Handler<Text|Container>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Text|Container */
+            function (State $State) {
+                if ($State->get(Breaks::class)->isEnabled()) {
+                    return new Container([
+                        Element::selfClosing('br', []),
+                        new Text("\n")
+                    ]);
+                }
+
+                return new Text("\n");
+            }
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text("\n");
+    }
+}

src/Components/Inlines/SpecialCharacter.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\RawHtml;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class SpecialCharacter implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $charCodeHtml;
+
+    /**
+     * @param string $charCodeHtml
+     */
+    private function __construct($charCodeHtml)
+    {
+        $this->charCodeHtml = $charCodeHtml;
+        $this->width = \strlen($charCodeHtml) + 2;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        if (\preg_match('/^&(#?+[0-9a-zA-Z]++);/', $Excerpt->text(), $matches)) {
+            return new self($matches[1]);
+        }
+
+        return null;
+    }
+
+    /** @return string */
+    public function charCode()
+    {
+        return $this->charCodeHtml;
+    }
+
+    /**
+     * @return RawHtml
+     */
+    public function stateRenderable()
+    {
+        return new RawHtml(
+            '&' . (new Text($this->charCode()))->getHtml() . ';'
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text('&'.$this->charCode().';');
+    }
+}

src/Components/Inlines/Strikethrough.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\Handler;
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class Strikethrough implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $text
+     * @param int $width
+     */
+    private function __construct($text, $width)
+    {
+        $this->text = $text;
+        $this->width = $width;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        $text = $Excerpt->text();
+
+        if (\preg_match('/^~~(?=\S)(.+?)(?<=\S)~~/', $text, $matches)) {
+            return new self($matches[1], \strlen($matches[0]));
+        }
+
+        return null;
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+
+    /**
+     * @return Handler<Element>
+     */
+    public function stateRenderable()
+    {
+        return new Handler(
+            /** @return Element */
+            function (State $State) {
+                return new Element(
+                    'del',
+                    [],
+                    $State->applyTo(Parsedown::line($this->text(), $State))
+                );
+            }
+        );
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->text());
+    }
+}

src/Components/Inlines/Url.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\BacktrackingInline;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class Url implements BacktrackingInline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $url;
+
+    /** @var int */
+    private $position;
+
+    /**
+     * @param string $url
+     * @param int $position
+     */
+    private function __construct($url, $position)
+    {
+        $this->url = $url;
+        $this->width = \strlen($url);
+        $this->position = $position;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        if (\preg_match(
+            '/(?<=^|\s|[*_~(])https?+:[\/]{2}[^\s<]+\b\/*+/ui',
+            $Excerpt->context(),
+            $matches,
+            \PREG_OFFSET_CAPTURE
+        )) {
+            return new self($matches[0][0], \intval($matches[0][1]));
+        }
+
+        return null;
+    }
+
+    /**
+     * Return an integer to declare that the inline should be treated as if it
+     * started from that position in the excerpt given to static::build.
+     * Return null to use the excerpt offset value.
+     * @return int|null
+     * */
+    public function modifyStartPositionTo()
+    {
+        return $this->position;
+    }
+
+    /** @return string */
+    public function url()
+    {
+        return $this->url;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return new Element('a', ['href' => $this->url()], [new Text($this->url())]);
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->url());
+    }
+}

src/Components/Inlines/UrlTag.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Html\Renderables\Element;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\State;
+
+final class UrlTag implements Inline
+{
+    use WidthTrait;
+
+    /** @var string */
+    private $url;
+
+    /**
+     * @param string $url
+     * @param int $width
+     */
+    private function __construct($url, $width)
+    {
+        $this->url = $url;
+        $this->width = $width;
+    }
+
+    /**
+     * @param Excerpt $Excerpt
+     * @param State $State
+     * @return static|null
+     */
+    public static function build(Excerpt $Excerpt, State $State)
+    {
+        if (\preg_match('/^<(\w++:\/{2}[^ >]++)>/i', $Excerpt->text(), $matches)) {
+            return new self($matches[1], \strlen($matches[0]));
+        }
+
+        return null;
+    }
+
+    /** @return string */
+    public function url()
+    {
+        return $this->url;
+    }
+
+    /**
+     * @return Element
+     */
+    public function stateRenderable()
+    {
+        return new Element('a', ['href' => $this->url()], [new Text($this->url())]);
+    }
+
+    /**
+     * @return Text
+     */
+    public function bestPlaintext()
+    {
+        return new Text($this->url);
+    }
+}

src/Components/Inlines/WidthTrait.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Erusev\Parsedown\Components\Inlines;
+
+trait WidthTrait
+{
+    /** @var int */
+    private $width;
+
+    /** @return int */
+    public function width()
+    {
+        return $this->width;
+    }
+}

src/Components/StateUpdatingBlock.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Erusev\Parsedown\Components;
+
+use Erusev\Parsedown\State;
+
+interface StateUpdatingBlock extends Block
+{
+    /** @return State */
+    public function latestState();
+}

src/Configurable.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace Erusev\Parsedown;
+
+interface Configurable
+{
+    /** @return static */
+    public static function initial();
+}

src/Configurables/BlockTypes.php

@@ -0,0 +1,194 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\Blocks\BlockQuote;
+use Erusev\Parsedown\Components\Blocks\FencedCode;
+use Erusev\Parsedown\Components\Blocks\Header;
+use Erusev\Parsedown\Components\Blocks\IndentedCode;
+use Erusev\Parsedown\Components\Blocks\Markup as BlockMarkup;
+use Erusev\Parsedown\Components\Blocks\Reference;
+use Erusev\Parsedown\Components\Blocks\Rule;
+use Erusev\Parsedown\Components\Blocks\SetextHeader;
+use Erusev\Parsedown\Components\Blocks\Table;
+use Erusev\Parsedown\Components\Blocks\TList;
+use Erusev\Parsedown\Configurable;
+
+final class BlockTypes implements Configurable
+{
+    /** @var array<array-key, array<int, class-string<Block>>> */
+    private static $defaultBlockTypes = [
+        '#' => [Header::class],
+        '*' => [Rule::class, TList::class],
+        '+' => [TList::class],
+        '-' => [SetextHeader::class, Table::class, Rule::class, TList::class],
+        '0' => [TList::class],
+        '1' => [TList::class],
+        '2' => [TList::class],
+        '3' => [TList::class],
+        '4' => [TList::class],
+        '5' => [TList::class],
+        '6' => [TList::class],
+        '7' => [TList::class],
+        '8' => [TList::class],
+        '9' => [TList::class],
+        ':' => [Table::class],
+        '<' => [BlockMarkup::class],
+        '=' => [SetextHeader::class],
+        '>' => [BlockQuote::class],
+        '[' => [Reference::class],
+        '_' => [Rule::class],
+        '`' => [FencedCode::class],
+        '|' => [Table::class],
+        '~' => [FencedCode::class],
+    ];
+
+    /** @var array<int, class-string<Block>> */
+    private static $defaultUnmarkedBlockTypes = [
+        IndentedCode::class,
+    ];
+
+    /** @var array<array-key, array<int, class-string<Block>>> */
+    private $blockTypes;
+
+    /** @var array<int, class-string<Block>> */
+    private $unmarkedBlockTypes;
+
+    /**
+     * @param array<array-key, array<int, class-string<Block>>> $blockTypes
+     * @param array<int, class-string<Block>> $unmarkedBlockTypes
+     */
+    public function __construct(array $blockTypes, array $unmarkedBlockTypes)
+    {
+        $this->blockTypes = $blockTypes;
+        $this->unmarkedBlockTypes = $unmarkedBlockTypes;
+    }
+
+    /** @return self */
+    public static function initial()
+    {
+        return new self(
+            self::$defaultBlockTypes,
+            self::$defaultUnmarkedBlockTypes
+        );
+    }
+
+    /**
+     * @param string $marker
+     * @param array<int, class-string<Block>> $newBlockTypes
+     * @return self
+     */
+    public function settingMarked($marker, array $newBlockTypes)
+    {
+        $blockTypes = $this->blockTypes;
+        $blockTypes[$marker] = $newBlockTypes;
+
+        return new self($blockTypes, $this->unmarkedBlockTypes);
+    }
+
+    /**
+     * @param string $marker
+     * @param array<int, class-string<Block>> $newBlockTypes
+     * @return self
+     */
+    public function addingMarkedHighPrecedence($marker, array $newBlockTypes)
+    {
+        return $this->settingMarked(
+            $marker,
+            \array_merge(
+                $newBlockTypes,
+                isset($this->blockTypes[$marker]) ? $this->blockTypes[$marker] : []
+            )
+        );
+    }
+
+    /**
+     * @param string $marker
+     * @param array<int, class-string<Block>> $newBlockTypes
+     * @return self
+     */
+    public function addingMarkedLowPrecedence($marker, array $newBlockTypes)
+    {
+        return $this->settingMarked(
+            $marker,
+            \array_merge(
+                isset($this->blockTypes[$marker]) ? $this->blockTypes[$marker] : [],
+                $newBlockTypes
+            )
+        );
+    }
+
+    /**
+     * @param array<int, class-string<Block>> $newUnmarkedBlockTypes
+     * @return self
+     */
+    public function settingUnmarked(array $newUnmarkedBlockTypes)
+    {
+        return new self($this->blockTypes, $newUnmarkedBlockTypes);
+    }
+
+    /**
+     * @param array<int, class-string<Block>> $newBlockTypes
+     * @return self
+     */
+    public function addingUnmarkedHighPrecedence(array $newBlockTypes)
+    {
+        return $this->settingUnmarked(
+            \array_merge($newBlockTypes, $this->unmarkedBlockTypes)
+        );
+    }
+
+    /**
+     * @param array<int, class-string<Block>> $newBlockTypes
+     * @return self
+     */
+    public function addingUnmarkedLowPrecedence(array $newBlockTypes)
+    {
+        return $this->settingUnmarked(
+            \array_merge($this->unmarkedBlockTypes, $newBlockTypes)
+        );
+    }
+
+    /**
+     * @param array<int, class-string<Block>> $removeBlockTypes
+     * @return self
+     */
+    public function removing(array $removeBlockTypes)
+    {
+        return new self(
+            \array_map(
+                /**
+                 * @param array<int, class-string<Block>> $blockTypes
+                 * @return array<int, class-string<Block>>
+                 */
+                function ($blockTypes) use ($removeBlockTypes) {
+                    return \array_diff($blockTypes, $removeBlockTypes);
+                },
+                $this->blockTypes
+            ),
+            \array_diff($this->unmarkedBlockTypes, $removeBlockTypes)
+        );
+    }
+
+    /**
+     * @param string $marker
+     * @return array<int, class-string<Block>>
+     */
+    public function markedBy($marker)
+    {
+        if (isset($this->blockTypes[$marker])) {
+            return $this->blockTypes[$marker];
+        }
+
+        return [];
+    }
+
+    /**
+     * @return array<int, class-string<Block>>
+     */
+    public function unmarked()
+    {
+        return $this->unmarkedBlockTypes;
+    }
+}

src/Configurables/BooleanConfigurable.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+trait BooleanConfigurable
+{
+    /** @var bool */
+    private $enabled = false;
+
+    /**
+     * @param bool $enabled
+     */
+    public function __construct($enabled)
+    {
+        $this->enabled = $enabled;
+    }
+
+    /** @return bool */
+    public function isEnabled()
+    {
+        return $this->enabled;
+    }
+
+    /** @return static */
+    public static function enabled()
+    {
+        return new self(true);
+    }
+
+    /** @return static */
+    public static function initial()
+    {
+        return new self(false);
+    }
+}

src/Configurables/Breaks.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Configurable;
+
+final class Breaks implements Configurable
+{
+    use BooleanConfigurable;
+}

src/Configurables/DefinitionBook.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Configurable;
+
+/**
+ * @psalm-type _Data=array{url: string, title: string|null}
+ */
+final class DefinitionBook implements Configurable
+{
+    /** @var array<string, _Data> */
+    private $book;
+
+    /**
+     * @param array<string, _Data> $book
+     */
+    public function __construct(array $book = [])
+    {
+        $this->book = $book;
+    }
+
+    /** @return self */
+    public static function initial()
+    {
+        return new self;
+    }
+
+    /**
+     * @param string $id
+     * @param _Data $data
+     * @return self
+     */
+    public function setting($id, array $data)
+    {
+        $book = $this->book;
+        $book[$id] = $data;
+
+        return new self($book);
+    }
+
+    /**
+     * @param string $id
+     * @return _Data|null
+     */
+    public function lookup($id)
+    {
+        if (isset($this->book[$id])) {
+            return $this->book[$id];
+        }
+
+        return null;
+    }
+}

src/Configurables/InlineTypes.php

@@ -0,0 +1,140 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Components\Inlines\Code;
+use Erusev\Parsedown\Components\Inlines\Email;
+use Erusev\Parsedown\Components\Inlines\Emphasis;
+use Erusev\Parsedown\Components\Inlines\EscapeSequence;
+use Erusev\Parsedown\Components\Inlines\HardBreak;
+use Erusev\Parsedown\Components\Inlines\Image;
+use Erusev\Parsedown\Components\Inlines\Link;
+use Erusev\Parsedown\Components\Inlines\Markup as InlineMarkup;
+use Erusev\Parsedown\Components\Inlines\SoftBreak;
+use Erusev\Parsedown\Components\Inlines\SpecialCharacter;
+use Erusev\Parsedown\Components\Inlines\Strikethrough;
+use Erusev\Parsedown\Components\Inlines\Url;
+use Erusev\Parsedown\Components\Inlines\UrlTag;
+use Erusev\Parsedown\Configurable;
+
+final class InlineTypes implements Configurable
+{
+    /** @var array<array-key, array<int, class-string<Inline>>> */
+    private static $defaultInlineTypes = [
+        '!' => [Image::class],
+        '*' => [Emphasis::class],
+        '_' => [Emphasis::class],
+        '&' => [SpecialCharacter::class],
+        '[' => [Link::class],
+        ':' => [Url::class],
+        '<' => [UrlTag::class, Email::class, InlineMarkup::class],
+        '`' => [Code::class],
+        '~' => [Strikethrough::class],
+        '\\' => [EscapeSequence::class],
+        "\n" => [HardBreak::class, SoftBreak::class],
+    ];
+
+    /** @var array<array-key, array<int, class-string<Inline>>> */
+    private $inlineTypes;
+
+    /** @var string */
+    private $inlineMarkers;
+
+    /**
+     * @param array<array-key, array<int, class-string<Inline>>> $inlineTypes
+     */
+    public function __construct(array $inlineTypes)
+    {
+        $this->inlineTypes = $inlineTypes;
+        $this->inlineMarkers = \implode('', \array_keys($inlineTypes));
+    }
+
+    /** @return self */
+    public static function initial()
+    {
+        return new self(self::$defaultInlineTypes);
+    }
+
+    /**
+     * @param string $marker
+     * @param array<int, class-string<Inline>> $newInlineTypes
+     * @return self
+     */
+    public function setting($marker, array $newInlineTypes)
+    {
+        $inlineTypes = $this->inlineTypes;
+        $inlineTypes[$marker] = $newInlineTypes;
+
+        return new self($inlineTypes);
+    }
+
+    /**
+     * @param string $marker
+     * @param array<int, class-string<Inline>> $newInlineTypes
+     * @return self
+     */
+    public function addingHighPrecedence($marker, array $newInlineTypes)
+    {
+        return $this->setting(
+            $marker,
+            \array_merge(
+                $newInlineTypes,
+                isset($this->inlineTypes[$marker]) ? $this->inlineTypes[$marker] : []
+            )
+        );
+    }
+
+    /**
+     * @param string $marker
+     * @param array<int, class-string<Inline>> $newInlineTypes
+     * @return self
+     */
+    public function addingLowPrecedence($marker, array $newInlineTypes)
+    {
+        return $this->setting(
+            $marker,
+            \array_merge(
+                isset($this->inlineTypes[$marker]) ? $this->inlineTypes[$marker] : [],
+                $newInlineTypes
+            )
+        );
+    }
+
+    /**
+     * @param array<int, class-string<Inline>> $removeInlineTypes
+     * @return self
+     */
+    public function removing(array $removeInlineTypes)
+    {
+        return new self(\array_map(
+            /**
+             * @param array<int, class-string<Inline>> $inlineTypes
+             * @return array<int, class-string<Inline>>
+             */
+            function ($inlineTypes) use ($removeInlineTypes) {
+                return \array_diff($inlineTypes, $removeInlineTypes);
+            },
+            $this->inlineTypes
+        ));
+    }
+
+    /**
+     * @param string $marker
+     * @return array<int, class-string<Inline>>
+     */
+    public function markedBy($marker)
+    {
+        if (isset($this->inlineTypes[$marker])) {
+            return $this->inlineTypes[$marker];
+        }
+
+        return [];
+    }
+
+    /** @return string */
+    public function markers()
+    {
+        return $this->inlineMarkers;
+    }
+}

src/Configurables/RecursionLimiter.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Configurable;
+
+final class RecursionLimiter implements Configurable
+{
+    /** @var int */
+    private $maxDepth;
+
+    /** @var int */
+    private $currentDepth;
+
+    /**
+     * @param int $maxDepth
+     * @param int $currentDepth
+     */
+    private function __construct($maxDepth, $currentDepth)
+    {
+        $this->maxDepth = $maxDepth;
+        $this->currentDepth = $currentDepth;
+    }
+
+    /** @return self */
+    public static function initial()
+    {
+        return self::maxDepth(256);
+    }
+
+    /**
+     * @param int $maxDepth
+     * @return self
+     */
+    public static function maxDepth($maxDepth)
+    {
+        return new self($maxDepth, 0);
+    }
+
+    /** @return self */
+    public function increment()
+    {
+        return new self($this->maxDepth, $this->currentDepth + 1);
+    }
+
+    /** @return bool */
+    public function isDepthExceeded()
+    {
+        return ($this->maxDepth < $this->currentDepth);
+    }
+}

src/Configurables/SafeMode.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Configurable;
+
+final class SafeMode implements Configurable
+{
+    use BooleanConfigurable;
+}

src/Configurables/StrictMode.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace Erusev\Parsedown\Configurables;
+
+use Erusev\Parsedown\Configurable;
+
+final class StrictMode implements Configurable
+{
+    use BooleanConfigurable;
+}

src/Html/Renderable.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Erusev\Parsedown\Html;
+
+use Erusev\Parsedown\AST\StateRenderable;
+
+interface Renderable extends StateRenderable
+{
+    /** @return string */
+    public function getHtml();
+}

src/Html/Renderables/CanonicalStateRenderable.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Renderables;
+
+use Erusev\Parsedown\Html\Renderable;
+use Erusev\Parsedown\State;
+
+trait CanonicalStateRenderable
+{
+    /**
+     * @return Renderable
+     */
+    public function renderable(State $State)
+    {
+        return $this;
+    }
+}

src/Html/Renderables/Container.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Renderables;
+
+use Erusev\Parsedown\Html\Renderable;
+
+final class Container implements Renderable
+{
+    use CanonicalStateRenderable;
+
+    /** @var Renderable[] */
+    private $Contents;
+
+    /**
+     * @param Renderable[] $Contents
+     */
+    public function __construct($Contents)
+    {
+        $this->Contents = $Contents;
+    }
+
+    /**
+     * @return Renderable[]
+     */
+    public function contents()
+    {
+        return $this->Contents;
+    }
+
+
+    /** @return string */
+    public function getHtml()
+    {
+        return \array_reduce(
+            $this->Contents,
+            /**
+             * @param string $html
+             * @param Renderable $Renderable
+             * @return string
+             */
+            function ($html, Renderable $Renderable) {
+                return $html . $Renderable->getHtml();
+            },
+            ''
+        );
+    }
+}

src/Html/Renderables/Element.php

@@ -0,0 +1,195 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Renderables;
+
+use Erusev\Parsedown\Html\Renderable;
+use Erusev\Parsedown\Html\Sanitisation\CharacterFilter;
+use Erusev\Parsedown\Html\Sanitisation\Escaper;
+
+final class Element implements Renderable
+{
+    use CanonicalStateRenderable;
+
+    /** @var array<string, true> */
+    public static $TEXT_LEVEL_ELEMENTS = [
+        'a' => true,
+        'b' => true,
+        'i' => true,
+        'q' => true,
+        's' => true,
+        'u' => true,
+
+        'br' => true,
+        'em' => true,
+        'rp' => true,
+        'rt' => true,
+        'tt' => true,
+        'xm' => true,
+
+        'bdo' => true,
+        'big' => true,
+        'del' => true,
+        'img' => true,
+        'ins' => true,
+        'kbd' => true,
+        'sub' => true,
+        'sup' => true,
+        'var' => true,
+        'wbr' => true,
+
+        'abbr' => true,
+        'cite' => true,
+        'code' => true,
+        'font' => true,
+        'mark' => true,
+        'nobr' => true,
+        'ruby' => true,
+        'span' => true,
+        'time' => true,
+
+        'blink' => true,
+        'small' => true,
+
+        'nextid' => true,
+        'spacer' => true,
+        'strike' => true,
+        'strong' => true,
+
+        'acronym' => true,
+        'listing' => true,
+        'marquee' => true,
+
+        'basefont' => true,
+    ];
+
+    /** @var string */
+    private $name;
+
+    /** @var array<string, string>*/
+    private $attributes;
+
+    /** @var Renderable[]|null */
+    private $Contents;
+
+    /**
+     * @param string $name
+     * @param array<string, string> $attributes
+     * @param Renderable[]|null $Contents
+     */
+    public function __construct($name, $attributes, $Contents)
+    {
+        $this->name = $name;
+        $this->attributes = $attributes;
+        $this->Contents = $Contents;
+    }
+
+    /**
+     * @param string $name
+     * @param array<string, string> $attributes
+     * @return self
+     */
+    public static function selfClosing($name, array $attributes)
+    {
+        return new self($name, $attributes, null);
+    }
+
+    /** @return string */
+    public function name()
+    {
+        return $this->name;
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function attributes()
+    {
+        return $this->attributes;
+    }
+
+    /**
+     * @return Renderable[]|null
+     */
+    public function contents()
+    {
+        return $this->Contents;
+    }
+
+    /**
+     * @param string $name
+     * @return self
+     */
+    public function settingName($name)
+    {
+        return new self($name, $this->attributes, $this->Contents);
+    }
+
+    /**
+     * @param array<string, string> $attributes
+     * @return self
+     */
+    public function settingAttributes(array $attributes)
+    {
+        return new self($this->name, $attributes, $this->Contents);
+    }
+
+    /**
+     * @param Renderable[]|null $Contents
+     * @return self
+     */
+    public function settingContents($Contents)
+    {
+        return new self($this->name, $this->attributes, $Contents);
+    }
+
+    /** @return string */
+    public function getHtml()
+    {
+        $elementName = CharacterFilter::htmlElementName($this->name);
+
+        $html = '<' . $elementName;
+
+        if (! empty($this->attributes)) {
+            foreach ($this->attributes as $name => $value) {
+                $html .= ' '
+                    . CharacterFilter::htmlAttributeName($name)
+                    . '="'
+                    . Escaper::htmlAttributeValue($value)
+                    . '"'
+                ;
+            }
+        }
+
+        if ($this->Contents !== null) {
+            $html .= '>';
+
+            if (! empty($this->Contents)) {
+                foreach ($this->Contents as $C) {
+                    if (
+                        $C instanceof Element
+                        && ! \array_key_exists(\strtolower($C->name()), self::$TEXT_LEVEL_ELEMENTS)
+                    ) {
+                        $html .= "\n";
+                    }
+
+                    $html .= $C->getHtml();
+                }
+
+                $Last = \end($this->Contents);
+
+                if (
+                    $Last instanceof Element
+                    && ! \array_key_exists(\strtolower($Last->name()), self::$TEXT_LEVEL_ELEMENTS)
+                ) {
+                    $html .= "\n";
+                }
+            }
+
+            $html .= "</" . $elementName . ">";
+        } else {
+            $html .= ' />';
+        }
+
+        return $html;
+    }
+}

src/Html/Renderables/Invisible.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Renderables;
+
+use Erusev\Parsedown\Html\Renderable;
+
+final class Invisible implements Renderable
+{
+    use CanonicalStateRenderable;
+
+    public function __construct()
+    {
+    }
+
+    /** @return string */
+    public function getHtml()
+    {
+        return '';
+    }
+}

src/Html/Renderables/RawHtml.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Renderables;
+
+use Erusev\Parsedown\Html\Renderable;
+
+final class RawHtml implements Renderable
+{
+    use CanonicalStateRenderable;
+
+    /** @var string */
+    private $html;
+
+    /**
+     * @param string $html
+     */
+    public function __construct($html = '')
+    {
+        $this->html = $html;
+    }
+
+    /** @return string */
+    public function getHtml()
+    {
+        return $this->html;
+    }
+}

src/Html/Renderables/Text.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Renderables;
+
+use Erusev\Parsedown\Html\Renderable;
+use Erusev\Parsedown\Html\Sanitisation\Escaper;
+
+final class Text implements Renderable
+{
+    use CanonicalStateRenderable;
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $text
+     */
+    public function __construct($text = '')
+    {
+        $this->text = $text;
+    }
+
+    /** @return string */
+    public function getStringBacking()
+    {
+        return $this->text;
+    }
+
+    /** @return string */
+    public function getHtml()
+    {
+        return Escaper::htmlElementValueEscapingDoubleQuotes($this->text);
+    }
+}

src/Html/Sanitisation/CharacterFilter.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Sanitisation;
+
+final class CharacterFilter
+{
+    /**
+     * @param string $text
+     * @return string
+     */
+    public static function htmlAttributeName($text)
+    {
+        /**
+         * https://www.w3.org/TR/html/syntax.html#name
+         *
+         * Attribute names must consist of one or more characters other than
+         * the space characters, U+0000 NULL, U+0022 QUOTATION MARK ("),
+         * U+0027 APOSTROPHE ('), U+003E GREATER-THAN SIGN (>),
+         * U+002F SOLIDUS (/), and U+003D EQUALS SIGN (=) characters,
+         * the control characters, and any characters that are not defined by
+         * Unicode.
+         */
+        return \preg_replace(
+            '/(?:[[:space:]\0"\'>\/=[:cntrl:]]|[^\pC\pL\pM\pN\pP\pS\pZ])++/iu',
+            '',
+            $text
+        );
+    }
+
+    /**
+     * @param string $text
+     * @return string
+     */
+    public static function htmlElementName($text)
+    {
+        /**
+         * https://www.w3.org/TR/html/syntax.html#tag-name
+         *
+         * HTML elements all have names that only use alphanumeric
+         * ASCII characters.
+         */
+        return \preg_replace('/[^[:alnum:]]/', '', $text);
+    }
+}

src/Html/Sanitisation/Escaper.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Sanitisation;
+
+final class Escaper
+{
+    /**
+     * @param string $text
+     * @return string
+     */
+    public static function htmlAttributeValue($text)
+    {
+        return self::escape($text);
+    }
+
+    /**
+     * @param string $text
+     * @return string
+     */
+    public static function htmlElementValue($text)
+    {
+        return self::escape($text, true);
+    }
+
+    /**
+     * @param string $text
+     * @return string
+     */
+    public static function htmlElementValueEscapingDoubleQuotes($text)
+    {
+        return \htmlspecialchars($text, \ENT_COMPAT, 'UTF-8');
+    }
+
+    /**
+     * @param string $text
+     * @param bool $allowQuotes
+     * @return string
+     */
+    private static function escape($text, $allowQuotes = false)
+    {
+        return \htmlspecialchars(
+            $text,
+            $allowQuotes ? \ENT_NOQUOTES : \ENT_QUOTES,
+            'UTF-8'
+        );
+    }
+}

src/Html/Sanitisation/UrlSanitiser.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Erusev\Parsedown\Html\Sanitisation;
+
+final class UrlSanitiser
+{
+    /** @var string[] */
+    private static $COMMON_SCHEMES = [
+        'http://',
+        'https://',
+        'ftp://',
+        'ftps://',
+        'mailto:',
+        'tel:',
+        'data:image/png;base64,',
+        'data:image/gif;base64,',
+        'data:image/jpeg;base64,',
+        'irc:',
+        'ircs:',
+        'git:',
+        'ssh:',
+        'news:',
+        'steam:',
+    ];
+
+    /**
+     * Disable literal intepretation of unknown scheme in $url. Returns the
+     * filtered version of $url.
+     * @param string $url
+     * @param string[]|null $permittedSchemes
+     * @return string
+     */
+    public static function filter($url, $permittedSchemes = null)
+    {
+        if (! isset($permittedSchemes)) {
+            $permittedSchemes = self::$COMMON_SCHEMES;
+        }
+
+        foreach ($permittedSchemes as $scheme) {
+            if (self::striAtStart($url, $scheme)) {
+                return $url;
+            }
+        }
+
+        return \str_replace(':', '%3A', $url);
+    }
+
+    /**
+     * @param string $string
+     * @param string $needle
+     * @return bool
+     */
+    private static function striAtStart($string, $needle)
+    {
+        $needleLen = \strlen($needle);
+
+        return \strtolower(\substr($string, 0, $needleLen)) === \strtolower($needle);
+    }
+}

src/Parsedown.php

@@ -0,0 +1,286 @@
+<?php
+
+namespace Erusev\Parsedown;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Components\AcquisitioningBlock;
+use Erusev\Parsedown\Components\BacktrackingInline;
+use Erusev\Parsedown\Components\Block;
+use Erusev\Parsedown\Components\Blocks\Paragraph;
+use Erusev\Parsedown\Components\ContinuableBlock;
+use Erusev\Parsedown\Components\Inline;
+use Erusev\Parsedown\Components\Inlines\PlainText;
+use Erusev\Parsedown\Components\StateUpdatingBlock;
+use Erusev\Parsedown\Configurables\BlockTypes;
+use Erusev\Parsedown\Configurables\InlineTypes;
+use Erusev\Parsedown\Configurables\RecursionLimiter;
+use Erusev\Parsedown\Html\Renderable;
+use Erusev\Parsedown\Html\Renderables\Text;
+use Erusev\Parsedown\Parsing\Excerpt;
+use Erusev\Parsedown\Parsing\Line;
+use Erusev\Parsedown\Parsing\Lines;
+
+final class Parsedown
+{
+    const version = '2.0.0-dev';
+
+    /** @var State */
+    private $State;
+
+    public function __construct(StateBearer $StateBearer = null)
+    {
+        $StateBearer = $StateBearer ?: new State;
+
+        $this->State = $StateBearer->state();
+    }
+
+    /**
+     * @param string $text
+     * @return string
+     */
+    public function text($text)
+    {
+        list($StateRenderables, $State) = self::lines(
+            Lines::fromTextLines($text, 0),
+            $this->State
+        );
+
+        $Renderables = $State->applyTo($StateRenderables);
+
+        $html = self::render($Renderables);
+
+        return $html;
+    }
+
+    /**
+     * @return array{0: StateRenderable[], 1: State}
+     */
+    public static function lines(Lines $Lines, State $State)
+    {
+        list($Blocks, $State) = self::blocks($Lines, $State);
+
+        return [self::stateRenderablesFrom($Blocks), $State];
+    }
+
+    /**
+     * @param Component[] $Components
+     * @return StateRenderable[]
+     */
+    public static function stateRenderablesFrom($Components)
+    {
+        return \array_map(
+            /**
+             * @param Component $Component
+             * @return StateRenderable
+             */
+            function ($Component) { return $Component->stateRenderable(); },
+            $Components
+        );
+    }
+
+    /**
+     * @return array{0: Block[], 1: State}
+     */
+    public static function blocks(Lines $Lines, State $State)
+    {
+        $RecursionLimiter = $State->get(RecursionLimiter::class)->increment();
+
+        if ($RecursionLimiter->isDepthExceeded()) {
+            $State = $State->setting(new BlockTypes([], []));
+        }
+
+        $State = $State->setting($RecursionLimiter);
+
+        /** @var Block[] */
+        $Blocks = [];
+        /** @var Block|null */
+        $Block = null;
+        /** @var Block|null */
+        $CurrentBlock = null;
+
+        foreach ($Lines->contexts() as $Context) {
+            $Line = $Context->line();
+
+            if (
+                isset($CurrentBlock)
+                && $CurrentBlock instanceof ContinuableBlock
+                && ! $CurrentBlock instanceof Paragraph
+            ) {
+                $Block = $CurrentBlock->advance($Context, $State);
+
+                if ($Block instanceof StateUpdatingBlock) {
+                    $State = $Block->latestState();
+                }
+
+                if (isset($Block)) {
+                    $CurrentBlock = $Block;
+
+                    continue;
+                }
+            }
+
+            $marker = \substr($Line->text(), 0, 1);
+
+            $potentialBlockTypes = \array_merge(
+                $State->get(BlockTypes::class)->unmarked(),
+                $State->get(BlockTypes::class)->markedBy($marker)
+            );
+
+            foreach ($potentialBlockTypes as $blockType) {
+                $Block = $blockType::build($Context, $State, $CurrentBlock);
+
+                if (isset($Block)) {
+                    if ($Block instanceof StateUpdatingBlock) {
+                        $State = $Block->latestState();
+                    }
+
+                    if (isset($CurrentBlock)
+                        && (
+                            ! $Block instanceof AcquisitioningBlock
+                            || ! $Block->acquiredPrevious()
+                        )
+                    ) {
+                        $Blocks[] = $CurrentBlock;
+                    }
+
+                    $CurrentBlock = $Block;
+
+                    continue 2;
+                }
+            }
+
+            if (isset($CurrentBlock) && $CurrentBlock instanceof Paragraph) {
+                $Block = $CurrentBlock->advance($Context, $State);
+            }
+
+            if (isset($Block)) {
+                $CurrentBlock = $Block;
+            } else {
+                if (isset($CurrentBlock)) {
+                    $Blocks[] = $CurrentBlock;
+                }
+
+                $CurrentBlock = Paragraph::build($Context, $State);
+            }
+        }
+
+        if (isset($CurrentBlock)) {
+            $Blocks[] = $CurrentBlock;
+        }
+
+        return [$Blocks, $State];
+    }
+
+    /**
+     * @param string $text
+     * @return StateRenderable[]
+     */
+    public static function line($text, State $State)
+    {
+        return self::stateRenderablesFrom(self::inlines($text, $State));
+    }
+
+    /**
+     * @param string $text
+     * @return Inline[]
+     */
+    public static function inlines($text, State $State)
+    {
+        # standardize line breaks
+        $text = \str_replace(["\r\n", "\r"], "\n", $text);
+
+        $RecursionLimiter = $State->get(RecursionLimiter::class)->increment();
+
+        if ($RecursionLimiter->isDepthExceeded()) {
+            return [Plaintext::build(new Excerpt($text, 0), $State)];
+        }
+
+        $State = $State->setting($RecursionLimiter);
+
+        /** @var Inline[] */
+        $Inlines = [];
+
+        # $excerpt is based on the first occurrence of a marker
+
+        $InlineTypes = $State->get(InlineTypes::class);
+        $markerMask = $InlineTypes->markers();
+
+        for (
+            $Excerpt = (new Excerpt($text, 0))->pushingOffsetTo($markerMask);
+            $Excerpt->text() !== '';
+            $Excerpt = $Excerpt->pushingOffsetTo($markerMask)
+        ) {
+            $marker = \substr($Excerpt->text(), 0, 1);
+
+            foreach ($InlineTypes->markedBy($marker) as $inlineType) {
+                $Inline = $inlineType::build($Excerpt, $State);
+
+                if (! isset($Inline)) {
+                    continue;
+                }
+
+                $markerPosition = $Excerpt->offset();
+
+                /** @var int|null */
+                $startPosition = null;
+
+                if ($Inline instanceof BacktrackingInline) {
+                    $startPosition = $Inline->modifyStartPositionTo();
+                }
+
+                if (! isset($startPosition)) {
+                    $startPosition = $markerPosition;
+                }
+
+                $endPosition = $startPosition + $Inline->width();
+
+                if ($startPosition > $markerPosition
+                    || $endPosition < $markerPosition
+                    || $startPosition < 0
+                ) {
+                    continue;
+                }
+
+                $Inlines[] = Plaintext::build($Excerpt->choppingUpToOffset($startPosition), $State);
+
+                $Inlines[] = $Inline;
+
+                /** @psalm-suppress LoopInvalidation */
+                $Excerpt = $Excerpt->choppingFromOffset($endPosition);
+
+                continue 2;
+            }
+
+            /** @psalm-suppress LoopInvalidation */
+            $Excerpt = $Excerpt->addingToOffset(1);
+        }
+
+        $Inlines[] = Plaintext::build($Excerpt->choppingFromOffset(0), $State);
+
+        return $Inlines;
+    }
+
+    /**
+     * @param Renderable[] $Renderables
+     * @return string
+     */
+    public static function render(array $Renderables)
+    {
+        return \trim(
+            \array_reduce(
+                $Renderables,
+                /**
+                 * @param string $html
+                 * @return string
+                 */
+                function ($html, Renderable $Renderable) {
+                    $newHtml = $Renderable->getHtml();
+
+                    return $html . ($newHtml === '' ? '' : "\n") . $newHtml;
+                },
+                ''
+            ),
+            "\n"
+        );
+    }
+}

src/Parsing/Context.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Erusev\Parsedown\Parsing;
+
+final class Context
+{
+    /** @var Line */
+    private $Line;
+
+    /** @var int */
+    private $previousEmptyLines;
+
+    /** @var string */
+    private $previousEmptyLinesText;
+
+    /**
+     * @param Line $Line
+     * @param string $previousEmptyLinesText
+     */
+    public function __construct($Line, $previousEmptyLinesText)
+    {
+        $this->Line = $Line;
+        $this->previousEmptyLinesText = $previousEmptyLinesText;
+        $this->previousEmptyLines = \substr_count($previousEmptyLinesText, "\n");
+    }
+
+    /** @return Line */
+    public function line()
+    {
+        return $this->Line;
+    }
+
+    /** @return int */
+    public function previousEmptyLines()
+    {
+        return $this->previousEmptyLines;
+    }
+
+    /** @return string */
+    public function previousEmptyLinesText()
+    {
+        return $this->previousEmptyLinesText;
+    }
+}

src/Parsing/Excerpt.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace Erusev\Parsedown\Parsing;
+
+final class Excerpt
+{
+    /** @var string */
+    private $context;
+
+    /** @var int */
+    private $offset;
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $context
+     * @param int $offset
+     */
+    public function __construct($context, $offset)
+    {
+        $this->context = $context;
+        $this->offset = $offset;
+        $this->text = \substr($context, $offset);
+
+        // only necessary pre-php7
+        if ($this->text === false) {
+            $this->text = '';
+        }
+    }
+
+    /**
+     * @param string $mask
+     * @return self
+     */
+    public function pushingOffsetTo($mask)
+    {
+        return $this->addingToOffset(\strcspn($this->text, $mask));
+    }
+
+    /**
+     * @param int $offset
+     * @return self
+     */
+    public function choppingFromOffset($offset)
+    {
+        return new self(\substr($this->context, $offset), 0);
+    }
+
+    /**
+     * @param int $offset
+     * @return self
+     */
+    public function choppingUpToOffset($offset)
+    {
+        return new self(\substr($this->context, 0, $offset), 0);
+    }
+
+    /**
+     * @param int $offsetIncrement
+     * @return self
+     */
+    public function addingToOffset($offsetIncrement)
+    {
+        return new self($this->context, $this->offset + $offsetIncrement);
+    }
+
+    /** @return string */
+    public function context()
+    {
+        return $this->context;
+    }
+
+    /** @return int */
+    public function offset()
+    {
+        return $this->offset;
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+}

src/Parsing/Line.php

@@ -0,0 +1,138 @@
+<?php
+
+namespace Erusev\Parsedown\Parsing;
+
+final class Line
+{
+    const INDENT_STEP = 4;
+
+    /** @var int */
+    private $indent;
+
+    /** @var int */
+    private $indentOffset;
+
+    /** @var string */
+    private $rawLine;
+
+    /** @var string */
+    private $text;
+
+    /**
+     * @param string $line
+     * @param int $indentOffset
+     */
+    public function __construct($line, $indentOffset = 0)
+    {
+        $this->rawLine = $line;
+        $this->indentOffset = $indentOffset % self::INDENT_STEP;
+
+        $lineWithoutTabs = self::indentTabsToSpaces($line, $indentOffset);
+
+        $this->indent = \strspn($lineWithoutTabs, ' ');
+        $this->text = \substr($lineWithoutTabs, $this->indent);
+    }
+
+    /** @return int */
+    public function indentOffset()
+    {
+        return $this->indentOffset;
+    }
+
+    /** @return string */
+    public function rawLine()
+    {
+        return $this->rawLine;
+    }
+
+    /**
+     * @param int $fromPosition
+     * @param int $indentOffset
+     * @return int
+     */
+    public static function tabShortage($fromPosition, $indentOffset)
+    {
+        return self::INDENT_STEP - ($fromPosition + $indentOffset) % self::INDENT_STEP;
+    }
+
+    /**
+     * @param string $text
+     * @param int $indentOffset
+     * @return string
+     */
+    private static function indentTabsToSpaces($text, $indentOffset = 0)
+    {
+        $rawIndentLen = \strspn($text, " \t");
+        $indentString = \substr($text, 0, $rawIndentLen);
+        $latterString = \substr($text, $rawIndentLen);
+
+        while (($beforeTab = \strstr($indentString, "\t", true)) !== false) {
+            $shortage = self::tabShortage(\mb_strlen($beforeTab, 'UTF-8'), $indentOffset);
+
+            $indentString = $beforeTab
+                . \str_repeat(' ', $shortage)
+                . \substr($indentString, \strlen($beforeTab) + 1)
+            ;
+        }
+
+        return $indentString . $latterString;
+    }
+
+    /**
+     * @param int $pos
+     * @return string
+     */
+    public function ltrimBodyUpto($pos)
+    {
+        if ($pos <= 0) {
+            return $this->rawLine;
+        }
+
+        if ($pos >= $this->indent) {
+            return \ltrim($this->rawLine, "\t ");
+        }
+
+        $rawIndentLen = \strspn($this->rawLine, " \t");
+        $rawIndentString = \substr($this->rawLine, 0, $rawIndentLen);
+
+        $effectiveIndent = 0;
+
+        foreach (\str_split($rawIndentString) as $n => $char) {
+            if ($char === "\t") {
+                $shortage = self::tabShortage($effectiveIndent, $this->indentOffset);
+
+                $effectiveIndent += $shortage;
+
+                if ($effectiveIndent >= $pos) {
+                    $overshoot = $effectiveIndent - $pos;
+
+                    return \str_repeat(' ', $overshoot) . \substr($this->rawLine, $n + 1);
+                }
+
+                continue;
+            } else {
+                $effectiveIndent += 1;
+
+                if ($effectiveIndent === $pos) {
+                    return \substr($this->rawLine, $n + 1);
+                }
+
+                continue;
+            }
+        }
+
+        return \ltrim($this->rawLine, "\t ");
+    }
+
+    /** @return int */
+    public function indent()
+    {
+        return $this->indent;
+    }
+
+    /** @return string */
+    public function text()
+    {
+        return $this->text;
+    }
+}

src/Parsing/Lines.php

@@ -0,0 +1,179 @@
+<?php
+
+namespace Erusev\Parsedown\Parsing;
+
+final class Lines
+{
+    /** @var Context[] */
+    private $Contexts;
+
+    /** @var bool */
+    private $containsBlankLines;
+
+    /** @var string */
+    private $trailingBlankLinesText;
+
+    /** @var int */
+    private $trailingBlankLines;
+
+    /**
+     * @param Context[] $Contexts
+     * @param string $trailingBlankLinesText
+     */
+    private function __construct($Contexts, $trailingBlankLinesText)
+    {
+        $this->Contexts = $Contexts;
+        $this->trailingBlankLinesText = $trailingBlankLinesText;
+        $this->trailingBlankLines = \substr_count($trailingBlankLinesText, "\n");
+
+        $containsBlankLines = $this->trailingBlankLines > 0;
+
+        if (! $containsBlankLines) {
+            foreach ($Contexts as $Context) {
+                if ($Context->previousEmptyLines() > 0) {
+                    $containsBlankLines = true;
+                    break;
+                }
+            }
+        }
+
+        $this->containsBlankLines = $containsBlankLines;
+    }
+
+    /** @return self */
+    public static function none()
+    {
+        return new self([], '');
+    }
+
+    /**
+     * @param string $text
+     * @param int $indentOffset
+     * @return self
+     */
+    public static function fromTextLines($text, $indentOffset)
+    {
+        # standardize line breaks
+        $text = \str_replace(["\r\n", "\r"], "\n", $text);
+
+        $Contexts = [];
+        $sequentialLines = '';
+
+        foreach (\explode("\n", $text) as $line) {
+            if (\chop($line) === '') {
+                $sequentialLines .= $line . "\n";
+                continue;
+            }
+
+            $Contexts[] = new Context(
+                new Line($line, $indentOffset),
+                $sequentialLines
+            );
+
+            $sequentialLines = '';
+        }
+
+        return new self($Contexts, $sequentialLines);
+    }
+
+    /** @return bool */
+    public function isEmpty()
+    {
+        return \count($this->Contexts) === 0 && $this->trailingBlankLines === 0;
+    }
+
+    /** @return Context[] */
+    public function Contexts()
+    {
+        return $this->Contexts;
+    }
+
+    /** @return bool */
+    public function containsBlankLines()
+    {
+        return $this->containsBlankLines;
+    }
+
+    /** @return int */
+    public function trailingBlankLines()
+    {
+        return $this->trailingBlankLines;
+    }
+
+    /**
+     * @param int $count
+     * @return self
+     */
+    public function appendingBlankLines($count = 1)
+    {
+        if ($count < 0) {
+            $count = 0;
+        }
+
+        $Lines = clone($this);
+        $Lines->trailingBlankLinesText .= \str_repeat("\n", $count);
+        $Lines->trailingBlankLines += $count;
+        $Lines->containsBlankLines = $Lines->containsBlankLines || ($count > 0);
+
+        return $Lines;
+    }
+
+    /**
+     * @param string $text
+     * @param int $indentOffset
+     * @return Lines
+     */
+    public function appendingTextLines($text, $indentOffset)
+    {
+        $Lines = clone($this);
+
+        $NextLines = self::fromTextLines($text, $indentOffset);
+
+        if (\count($NextLines->Contexts) === 0) {
+            $Lines->trailingBlankLines += $NextLines->trailingBlankLines;
+            $Lines->trailingBlankLinesText .= $NextLines->trailingBlankLinesText;
+
+            $Lines->containsBlankLines = true;
+
+            return $Lines;
+        }
+
+        $NextLines->Contexts[0] = new Context(
+            $NextLines->Contexts[0]->line(),
+            $NextLines->Contexts[0]->previousEmptyLinesText() . $Lines->trailingBlankLinesText
+        );
+
+        $Lines->Contexts = \array_merge($Lines->Contexts, $NextLines->Contexts);
+
+        $Lines->trailingBlankLines = $NextLines->trailingBlankLines;
+        $Lines->trailingBlankLinesText = $NextLines->trailingBlankLinesText;
+
+        $Lines->containsBlankLines = $Lines->containsBlankLines
+            || $NextLines->containsBlankLines
+        ;
+
+        return $Lines;
+    }
+
+    /** @return Lines */
+    public function appendingContext(Context $Context)
+    {
+        $Lines = clone($this);
+
+        $Context = new Context(
+            $Context->line(),
+            $Context->previousEmptyLinesText() . $Lines->trailingBlankLinesText
+        );
+
+        if ($Context->previousEmptyLines() > 0) {
+            $Lines->containsBlankLines = true;
+        }
+
+        $Lines->trailingBlankLines = 0;
+        $Lines->trailingBlankLinesText = '';
+
+        $Lines->Contexts[] = $Context;
+
+        return $Lines;
+    }
+}

src/State.php

@@ -0,0 +1,99 @@
+<?php
+
+namespace Erusev\Parsedown;
+
+use Erusev\Parsedown\AST\StateRenderable;
+use Erusev\Parsedown\Html\Renderable;
+
+final class State implements StateBearer
+{
+    /**
+     * @var array<class-string<Configurable>, Configurable>
+     */
+    private $state;
+
+    /**
+     * @var array<class-string<Configurable>, Configurable>
+     */
+    private static $initialCache;
+
+    /**
+     * @param Configurable[] $Configurables
+     */
+    public function __construct(array $Configurables = [])
+    {
+        $this->state = \array_combine(
+            \array_map(
+                /** @return class-string */
+                function (Configurable $C) { return \get_class($C); },
+                $Configurables
+            ),
+            $Configurables
+        );
+    }
+
+    /**
+     * @return self
+     */
+    public function setting(Configurable $C)
+    {
+        return new self([\get_class($C) => $C] + $this->state);
+    }
+
+    /**
+     * @return self
+     */
+    public function mergingWith(State $State)
+    {
+        return new self($State->state + $this->state);
+    }
+
+    /**
+     * @template T as Configurable
+     * @template-typeof T $configurableClass
+     * @param class-string<Configurable> $configurableClass
+     * @return T
+     */
+    public function get($configurableClass)
+    {
+        if (isset($this->state[$configurableClass])) {
+            return $this->state[$configurableClass];
+        }
+
+        if (! isset(self::$initialCache[$configurableClass])) {
+            self::$initialCache[$configurableClass] = $configurableClass::initial();
+        }
+
+        return self::$initialCache[$configurableClass];
+    }
+
+    public function __clone()
+    {
+        $this->state = \array_map(
+            /** @return Configurable */
+            function (Configurable $C) { return clone($C); },
+            $this->state
+        );
+    }
+
+    /**
+     * @param StateRenderable[] $StateRenderables
+     * @return Renderable[]
+     */
+    public function applyTo(array $StateRenderables)
+    {
+        return \array_map(
+            /** @return Renderable */
+            function (StateRenderable $SR) { return $SR->renderable($this); },
+            $StateRenderables
+        );
+    }
+
+    /**
+     * @return State
+     */
+    public function state()
+    {
+        return $this;
+    }
+}

src/StateBearer.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Erusev\Parsedown;
+
+interface StateBearer
+{
+    /**
+     * @return State
+     */
+    public function state();
+}

tests/CommonMarkTest.php

@@ -0,0 +1,120 @@
+<?php
+
+namespace Erusev\Parsedown\Tests;
+
+/**
+ * Test Parsedown against cached expect-to-pass CommonMark spec examples
+ *
+ * This test suite runs tests the same way as `test/CommonMarkTestWeak.php`,
+ * but uses a cached set of CommonMark spec examples in `test/commonmark/`.
+ * It is executed along with Parsedown's default test suite and runs various
+ * CommonMark spec examples, which are expected to pass. If they don't pass,
+ * the Parsedown build fails. The intention of this test suite is to make sure,
+ * that previously passed CommonMark spec examples don't fail due to unwanted
+ * side-effects of code changes.
+ *
+ * You can re-create the `test/commonmark/` directory by executing the PHPUnit
+ * group `update`. The test suite will then run `test/CommonMarkTestWeak.php`
+ * and create files with the Markdown source and the resulting HTML markup of
+ * all passed tests. The command to execute looks like the following:
+ *
+ *     $ phpunit --group update
+ *
+ * @link http://commonmark.org/ CommonMark
+ */
+class CommonMarkTest extends CommonMarkTestStrict
+{
+    /**
+     * @return array<int, array{id: int, section: string, markdown: string, expectedHtml: string}>
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     */
+    public function data()
+    {
+        $data = [];
+
+        $dir = static::getDataDir();
+        $files = @\scandir($dir);
+        if (!empty($files)) {
+            foreach ($files as $file) {
+                if (($file === '.') || ($file === '..')) {
+                    continue;
+                }
+
+                if (\substr($file, -3) === '.md') {
+                    $testName = \substr($file, 0, -3);
+                    if (\file_exists($dir . $testName . '.html')) {
+                        \preg_match('/^(\d+)-(.*)$/', $testName, $matches);
+                        $id = isset($matches[1]) ? \intval($matches[1]) : 0;
+                        $section = isset($matches[2]) ? \preg_replace('/_+/', ' ', $matches[2]) : '';
+
+                        $markdown = \file_get_contents($dir . $testName . '.md');
+                        $expectedHtml = \file_get_contents($dir . $testName . '.html');
+
+                        $data[$id] = [
+                            'id' => $id,
+                            'section' => $section,
+                            'markdown' => $markdown,
+                            'expectedHtml' => $expectedHtml
+                        ];
+                    }
+                }
+            }
+        } else {
+            $this->fail('The CommonMark cache folder ' . $dir . ' is empty or not readable.');
+        }
+
+        return $data;
+    }
+
+    /**
+     * @group update
+     * @dataProvider dataUpdate
+     * @param int $id
+     * @param string $section
+     * @param string $markdown
+     * @param string $expectedHtml
+     * @return void
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     * @throws \SebastianBergmann\RecursionContext\InvalidArgumentException
+     */
+    public function testUpdateDatabase($id, $section, $markdown, $expectedHtml)
+    {
+        parent::testExample($id, $section, $markdown, $expectedHtml);
+
+        // you can only get here when the test passes
+        $dir = static::getDataDir(true);
+        $basename = \strval($id) . '-' . \preg_replace('/[^\w.-]/', '_', $section);
+        \file_put_contents($dir . $basename . '.md', $markdown);
+        \file_put_contents($dir . $basename . '.html', $expectedHtml);
+    }
+
+    /**
+     * @return array<int, array{id: int, section: string, markdown: string, expectedHtml: string}>
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     */
+    public function dataUpdate()
+    {
+        return parent::data();
+    }
+
+    /**
+     * @param bool $mkdir
+     * @return string
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     */
+    public static function getDataDir($mkdir = false)
+    {
+        $dir = __DIR__ . '/commonmark/';
+
+        if ($mkdir) {
+            if (!\file_exists($dir)) {
+                @\mkdir($dir);
+            }
+            if (!\is_dir($dir)) {
+                static::fail('Unable to create CommonMark cache folder ' . $dir . '.');
+            }
+        }
+
+        return $dir;
+    }
+}

tests/CommonMarkTestStrict.php

@@ -0,0 +1,120 @@
+<?php
+
+namespace Erusev\Parsedown\Tests;
+
+use Erusev\Parsedown\Components\Inlines\Url;
+use Erusev\Parsedown\Configurables\InlineTypes;
+use Erusev\Parsedown\Configurables\StrictMode;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\State;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Test Parsedown against the CommonMark spec
+ *
+ * @link http://commonmark.org/ CommonMark
+ */
+class CommonMarkTestStrict extends TestCase
+{
+    const SPEC_URL = 'https://raw.githubusercontent.com/jgm/CommonMark/master/spec.txt';
+    const SPEC_LOCAL_CACHE = 'spec_cache.txt';
+    const SPEC_CACHE_SECONDS = 300;
+
+    /** @var Parsedown */
+    protected $Parsedown;
+
+    /**
+     * @param string|null $name
+     * @param array $data
+     * @param string $dataName
+     */
+    public function __construct($name = null, array $data = [], $dataName = '')
+    {
+        $this->Parsedown = new Parsedown(new State([
+            StrictMode::enabled(),
+            InlineTypes::initial()->removing([Url::class]),
+        ]));
+
+        parent::__construct($name, $data, $dataName);
+    }
+
+    /**
+     * @dataProvider data
+     * @param int $_
+     * @param string $__
+     * @param string $markdown
+     * @param string $expectedHtml
+     * @return void
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     * @throws \SebastianBergmann\RecursionContext\InvalidArgumentException
+     */
+    public function testExample($_, $__, $markdown, $expectedHtml)
+    {
+        $actualHtml = $this->Parsedown->text($markdown);
+        $this->assertEquals($expectedHtml, $actualHtml);
+    }
+
+    /**
+     * @return string
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     */
+    public function getSpec()
+    {
+        $specPath = __DIR__ .'/'.self::SPEC_LOCAL_CACHE;
+
+        if (
+            \is_file($specPath)
+            && \time() - \filemtime($specPath) < self::SPEC_CACHE_SECONDS
+        ) {
+            $spec = \file_get_contents($specPath);
+        } else {
+            $spec = \file_get_contents(self::SPEC_URL);
+            \file_put_contents($specPath, $spec);
+        }
+
+        if ($spec === false) {
+            $this->fail('Unable to load CommonMark spec from ' . self::SPEC_URL);
+        }
+
+        return $spec;
+    }
+
+    /**
+     * @return array<int, array{id: int, section: string, markdown: string, expectedHtml: string}>
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     */
+    public function data()
+    {
+        $spec = $this->getSpec();
+
+        $spec = \str_replace("\r\n", "\n", $spec);
+        /** @var string */
+        $spec = \strstr($spec, '<!-- END TESTS -->', true);
+
+        $matches = [];
+        \preg_match_all('/^`{32} example\n((?s).*?)\n\.\n(?:|((?s).*?)\n)`{32}$|^#{1,6} *(.*?)$/m', $spec, $matches, \PREG_SET_ORDER);
+
+        $data = [];
+        $currentId = 0;
+        $currentSection = '';
+        /** @var array{0: string, 1: string, 2?: string, 3?: string} $match */
+        foreach ($matches as $match) {
+            if (isset($match[3])) {
+                $currentSection = $match[3];
+            } else {
+                $currentId++;
+                $markdown = \str_replace('→', "\t", $match[1]);
+                $expectedHtml = isset($match[2]) ? \str_replace('→', "\t", $match[2]) : '';
+
+                $data[$currentId] = [
+                    'id' => $currentId,
+                    'section' => $currentSection,
+                    'markdown' => $markdown,
+                    'expectedHtml' => $expectedHtml
+                ];
+            }
+        }
+
+        return $data;
+    }
+}

tests/CommonMarkTestWeak.php

@@ -0,0 +1,87 @@
+<?php
+
+namespace Erusev\Parsedown\Tests;
+
+use Erusev\Parsedown\Html\Renderables\Element;
+
+/**
+ * Test Parsedown against the CommonMark spec, but less aggressive
+ *
+ * The resulting HTML markup is cleaned up before comparison, so examples
+ * which would normally fail due to actually invisible differences (e.g.
+ * superfluous whitespaces), don't fail. However, cleanup relies on block
+ * element detection. The detection doesn't work correctly when a element's
+ * `display` CSS property is manipulated. According to that this test is only
+ * a interim solution on Parsedown's way to full CommonMark compatibility.
+ *
+ * @link http://commonmark.org/ CommonMark
+ */
+class CommonMarkTestWeak extends CommonMarkTestStrict
+{
+    /** @var string */
+    protected $textLevelElementRegex;
+
+    /**
+     * @param string|null $name
+     * @param array $data
+     * @param string $dataName
+     */
+    public function __construct($name = null, array $data = [], $dataName = '')
+    {
+        $textLevelElements = \array_keys(Element::$TEXT_LEVEL_ELEMENTS);
+
+        \array_walk(
+            $textLevelElements,
+            /**
+             * @param string &$element
+             * @return void
+             */
+            function (&$element) {
+                $element = \preg_quote($element, '/');
+            }
+        );
+        $this->textLevelElementRegex = '\b(?:' . \implode('|', $textLevelElements) . ')\b';
+
+        parent::__construct($name, $data, $dataName);
+    }
+
+    /**
+     * @dataProvider data
+     * @param int $_
+     * @param string $__
+     * @param string $markdown
+     * @param string $expectedHtml
+     * @return void
+     * @throws \PHPUnit\Framework\AssertionFailedError
+     * @throws \SebastianBergmann\RecursionContext\InvalidArgumentException
+     */
+    public function testExample($_, $__, $markdown, $expectedHtml)
+    {
+        $expectedHtml = $this->cleanupHtml($expectedHtml);
+
+        $actualHtml = $this->Parsedown->text($markdown);
+        $actualHtml = $this->cleanupHtml($actualHtml);
+
+        $this->assertEquals($expectedHtml, $actualHtml);
+    }
+
+    /**
+     * @param string $markup
+     * @return string
+     */
+    protected function cleanupHtml($markup)
+    {
+        // invisible whitespaces at the beginning and end of block elements
+        // however, whitespaces at the beginning of <pre> elements do matter
+        $markup = \preg_replace(
+            [
+                '/(<(?!(?:' . $this->textLevelElementRegex . '|\bpre\b))\w+\b[^>]*>(?:<' . $this->textLevelElementRegex . '[^>]*>)*)\s+/s',
+                '/\s+((?:<\/' . $this->textLevelElementRegex . '>)*<\/(?!' . $this->textLevelElementRegex . ')\w+\b>)/s'
+            ],
+            '$1',
+            $markup
+        );
+
+        return $markup;
+    }
+}

tests/ParsedownTest.php

@@ -0,0 +1,159 @@
+<?php
+
+namespace Erusev\Parsedown\Tests;
+
+use Erusev\Parsedown\Components\Blocks\Markup as BlockMarkup;
+use Erusev\Parsedown\Components\Inlines\Markup as InlineMarkup;
+use Erusev\Parsedown\Configurables\BlockTypes;
+use Erusev\Parsedown\Configurables\Breaks;
+use Erusev\Parsedown\Configurables\InlineTypes;
+use Erusev\Parsedown\Configurables\SafeMode;
+use Erusev\Parsedown\Configurables\StrictMode;
+use Erusev\Parsedown\Parsedown;
+use Erusev\Parsedown\State;
+use PHPUnit\Framework\TestCase;
+
+class ParsedownTest extends TestCase
+{
+    /**
+     * @param string|null $name
+     * @param array $data
+     * @param string $dataName
+     */
+    final public function __construct($name = null, array $data = [], $dataName = '')
+    {
+        $this->dirs = $this->initDirs();
+
+        parent::__construct($name, $data, $dataName);
+    }
+
+    /** @var string[]  */
+    private $dirs;
+
+    /**
+     * @return string[]
+     */
+    protected function initDirs()
+    {
+        return [\dirname(__FILE__).'/data/'];
+    }
+
+    /**
+     * @dataProvider data
+     * @param string $test
+     * @param string $dir
+     * @return void
+     * @throws \PHPUnit\Framework\ExpectationFailedException
+     * @throws \SebastianBergmann\RecursionContext\InvalidArgumentException
+     */
+    public function test_($test, $dir)
+    {
+        $markdown = \file_get_contents($dir . $test . '.md');
+
+        $expectedMarkup = \file_get_contents($dir . $test . '.html');
+
+        $expectedMarkup = \str_replace("\r\n", "\n", $expectedMarkup);
+        $expectedMarkup = \str_replace("\r", "\n", $expectedMarkup);
+
+        $Parsedown = new Parsedown(new State([
+            new SafeMode(\substr($test, 0, 3) === 'xss'),
+            new StrictMode(\substr($test, 0, 6) === 'strict'),
+            new Breaks(\substr($test, 0, 14) === 'breaks_enabled'),
+        ]));
+
+        $actualMarkup = $Parsedown->text($markdown);
+
+        $this->assertEquals($expectedMarkup, $actualMarkup);
+    }
+
+    /** @return array<int, array{0:string, 1:string} */
+    public function data()
+    {
+        $data = [];
+
+        foreach ($this->dirs as $dir) {
+            $Folder = new \DirectoryIterator($dir);
+
+            foreach ($Folder as $File) {
+                /** @var $File DirectoryIterator */
+
+                if (! $File->isFile()) {
+                    continue;
+                }
+
+                $filename = $File->getFilename();
+
+                $extension = \pathinfo($filename, \PATHINFO_EXTENSION);
+
+                if ($extension !== 'md') {
+                    continue;
+                }
+
+                $basename = $File->getBasename('.md');
+
+                if (\file_exists($dir . $basename . '.html')) {
+                    $data []= [$basename, $dir];
+                }
+            }
+        }
+
+        return $data;
+    }
+
+    /**
+     * @return void
+     * @throws \PHPUnit\Framework\ExpectationFailedException
+     * @throws \SebastianBergmann\RecursionContext\InvalidArgumentException
+     */
+    public function test_no_markup()
+    {
+        $markdownWithHtml = <<<MARKDOWN_WITH_MARKUP
+<div>_content_</div>
+
+sparse:
+
+<div>
+<div class="inner">
+_content_
+</div>
+</div>
+
+paragraph
+
+<style type="text/css">
+    p {
+        color: red;
+    }
+</style>
+
+comment
+
+<!-- html comment -->
+MARKDOWN_WITH_MARKUP;
+
+        $expectedHtml = <<<EXPECTED_HTML
+<p>&lt;div&gt;<em>content</em>&lt;/div&gt;</p>
+<p>sparse:</p>
+<p>&lt;div&gt;
+&lt;div class=&quot;inner&quot;&gt;
+<em>content</em>
+&lt;/div&gt;
+&lt;/div&gt;</p>
+<p>paragraph</p>
+<p>&lt;style type=&quot;text/css&quot;&gt;
+p {
+color: red;
+}
+&lt;/style&gt;</p>
+<p>comment</p>
+<p>&lt;!-- html comment --&gt;</p>
+EXPECTED_HTML;
+
+        $parsedownWithNoMarkup = new Parsedown(new State([
+            BlockTypes::initial()->removing([BlockMarkup::class]),
+            InlineTypes::initial()->removing([InlineMarkup::class]),
+        ]));
+
+        $this->assertEquals($expectedHtml, $parsedownWithNoMarkup->text($markdownWithHtml));
+    }
+}

tests/Test.php

@@ -1,47 +0,0 @@
-<?php
-
-include 'Parsedown.php';
-
-class Test extends PHPUnit_Framework_TestCase
-{
-	const provider_dir = 'data/';
-	
-	/**
-	 * @dataProvider provider
-	 */
-	function test_($markdown, $expected_markup)
-	{
-		$actual_markup = Parsedown::instance()->parse($markdown);
-
-		$this->assertEquals($expected_markup, $actual_markup);
-	}
-	
-	function provider()
-	{
-		$provider = array();
-		
-		$DirectoryIterator = new DirectoryIterator(__DIR__ . '/' . self::provider_dir);
-		
-		foreach ($DirectoryIterator as $Item)
-		{
-			if ($Item->isFile() and $Item->getExtension() === 'md')
-			{
-				$basename = $Item->getBasename('.md');
-				
-				$markdown = file_get_contents(__DIR__ . '/' . self::provider_dir . $basename . '.md');
-				
-				if (!$markdown)
-					continue;
-				
-				$expected_markup = file_get_contents(__DIR__ . '/' . self::provider_dir . $basename . '.html');
-				$expected_markup = str_replace("\r\n", "\n", $expected_markup);
-				$expected_markup = str_replace("\r", "\n", $expected_markup);
-				
-				$provider [] = array($markdown, $expected_markup);
-			}
-		}
-		
-		return $provider;
-	}
-}
-

tests/commonmark/1-Tabs.html

@@ -0,0 +1,2 @@
+<pre><code>foo	baz		bim
+</code></pre>

tests/commonmark/1-Tabs.md

@@ -0,0 +1 @@
+	foo	baz		bim

tests/commonmark/10-Tabs.html

@@ -0,0 +1 @@
+<h1>Foo</h1>

tests/commonmark/10-Tabs.md

@@ -0,0 +1 @@
+#	Foo

tests/commonmark/100-Fenced_code_blocks.html

@@ -0,0 +1 @@
+<pre><code></code></pre>

tests/commonmark/100-Fenced_code_blocks.md

@@ -0,0 +1,2 @@
+```
+```

tests/commonmark/103-Fenced_code_blocks.html

@@ -0,0 +1,4 @@
+<pre><code>```
+aaa
+```
+</code></pre>

tests/commonmark/103-Fenced_code_blocks.md

@@ -0,0 +1,3 @@
+    ```
+    aaa
+    ```

tests/commonmark/104-Fenced_code_blocks.html

@@ -0,0 +1,4 @@
+<pre><code>```
+aaa
+```
+</code></pre>

tests/commonmark/104-Fenced_code_blocks.md

@@ -0,0 +1,3 @@
+    ```
+    aaa
+    ```

tests/commonmark/105-Fenced_code_blocks.html

@@ -0,0 +1,2 @@
+<pre><code>aaa
+</code></pre>

tests/commonmark/105-Fenced_code_blocks.md

@@ -0,0 +1,3 @@
+```
+aaa
+  ```

tests/commonmark/106-Fenced_code_blocks.html

@@ -0,0 +1,2 @@
+<pre><code>aaa
+</code></pre>

tests/commonmark/106-Fenced_code_blocks.md

@@ -0,0 +1,3 @@
+   ```
+aaa
+  ```

tests/commonmark/107-Fenced_code_blocks.html

@@ -0,0 +1,2 @@
+<p><code></code>
+aaa</p>

tests/commonmark/107-Fenced_code_blocks.md

@@ -0,0 +1,2 @@
+``` ```
+aaa

tests/commonmark/108-Fenced_code_blocks.html

@@ -0,0 +1,3 @@
+<pre><code>aaa
+~~~ ~~
+</code></pre>

tests/commonmark/108-Fenced_code_blocks.md

@@ -0,0 +1,3 @@
+~~~~~~
+aaa
+~~~ ~~

tests/commonmark/109-Fenced_code_blocks.html

@@ -0,0 +1,3 @@
+<pre><code>aaa
+~~~ ~~
+</code></pre>

tests/commonmark/109-Fenced_code_blocks.md

@@ -0,0 +1,3 @@
+~~~~~~
+aaa
+~~~ ~~

tests/commonmark/11-Tabs.html

@@ -0,0 +1 @@
+<hr />

tests/commonmark/11-Tabs.md

@@ -0,0 +1 @@
+*	*	*	

tests/commonmark/110-Fenced_code_blocks.html

@@ -0,0 +1,4 @@
+<p>foo</p>
+<pre><code>bar
+</code></pre>
+<p>baz</p>