diff --git a/CHANGELOG.md b/CHANGELOG.md
index 300dd52036..6aa7d05d62 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,8 @@ Updates should follow the [Keep a CHANGELOG](https://keepachangelog.com/) princi
## [Unreleased][unreleased]
+## [2.3.0] - 2022-04-07
+
### Added
- Added new `EmbedExtension` (#805)
@@ -443,7 +445,8 @@ No changes were introduced since the previous release.
- Alternative 1: Use `CommonMarkConverter` or `GithubFlavoredMarkdownConverter` if you don't need to customize the environment
- Alternative 2: Instantiate a new `Environment` and add the necessary extensions yourself
-[unreleased]: https://github.com/thephpleague/commonmark/compare/2.2.3...main
+[unreleased]: https://github.com/thephpleague/commonmark/compare/2.3.0...main
+[2.3.0]: https://github.com/thephpleague/commonmark/compare/2.2.3...2.3.0
[2.2.3]: https://github.com/thephpleague/commonmark/compare/2.2.2...2.2.3
[2.2.2]: https://github.com/thephpleague/commonmark/compare/2.2.1...2.2.2
[2.2.1]: https://github.com/thephpleague/commonmark/compare/2.2.0...2.2.1
diff --git a/composer.json b/composer.json
index 49340e8c65..c0ef753481 100644
--- a/composer.json
+++ b/composer.json
@@ -111,7 +111,7 @@
},
"extra": {
"branch-alias": {
- "dev-main": "2.3-dev"
+ "dev-main": "2.4-dev"
}
},
"config": {
diff --git a/docs/2.1/basic-usage.md b/docs/2.1/basic-usage.md
index 63a82b9165..5c9fc607cb 100644
--- a/docs/2.1/basic-usage.md
+++ b/docs/2.1/basic-usage.md
@@ -2,7 +2,6 @@
layout: default
title: Basic Usage
description: Basic usage of the CommonMark parser
-redirect_from: /basic-usage/
---
# Basic Usage
diff --git a/docs/2.1/changelog.md b/docs/2.1/changelog.md
index aa3ce2024e..c992c4d1d1 100644
--- a/docs/2.1/changelog.md
+++ b/docs/2.1/changelog.md
@@ -2,7 +2,6 @@
layout: default
title: Changelog
description: Important changes made in recent releases
-redirect_from: /changelog/
---
# Changelog
diff --git a/docs/2.1/configuration.md b/docs/2.1/configuration.md
index 4a6576094c..99ea375e3c 100644
--- a/docs/2.1/configuration.md
+++ b/docs/2.1/configuration.md
@@ -1,7 +1,6 @@
---
layout: default
title: Configuration
-redirect_from: /configuration/
---
# Configuration
diff --git a/docs/2.1/customization/abstract-syntax-tree.md b/docs/2.1/customization/abstract-syntax-tree.md
index efd84d79b3..0ea61af21d 100644
--- a/docs/2.1/customization/abstract-syntax-tree.md
+++ b/docs/2.1/customization/abstract-syntax-tree.md
@@ -2,7 +2,6 @@
layout: default
title: Abstract Syntax Tree
description: Using the Abstract Syntax Tree (AST) to manipulate the parsed content
-redirect_from: /customization/abstract-syntax-tree/
---
# Abstract Syntax Tree
diff --git a/docs/2.1/customization/block-parsing.md b/docs/2.1/customization/block-parsing.md
index 35689194d3..10ea16aeaf 100644
--- a/docs/2.1/customization/block-parsing.md
+++ b/docs/2.1/customization/block-parsing.md
@@ -2,7 +2,6 @@
layout: default
title: Block Parsing
description: How to parse block-level elements
-redirect_from: /customization/block-parsing/
---
# Block Parsing
diff --git a/docs/2.1/customization/configuration.md b/docs/2.1/customization/configuration.md
index 52b08e44b7..f5016a7d9d 100644
--- a/docs/2.1/customization/configuration.md
+++ b/docs/2.1/customization/configuration.md
@@ -2,7 +2,6 @@
layout: default
title: Configuration
description: Defining configuration schemas and accessing user-provided configuration options within your custom extensions
-redirect_from: /customization/configuration/
---
# Configuration Schemas and Values
diff --git a/docs/2.1/customization/cursor.md b/docs/2.1/customization/cursor.md
index 8279b54064..83feb637d0 100644
--- a/docs/2.1/customization/cursor.md
+++ b/docs/2.1/customization/cursor.md
@@ -2,7 +2,6 @@
layout: default
title: Cursor
description: Using the Cursor object to parse Markdown content
-redirect_from: /customization/cursor/
---
# Cursor
diff --git a/docs/2.1/customization/delimiter-processing.md b/docs/2.1/customization/delimiter-processing.md
index 95aac3ead8..cbef52ca58 100644
--- a/docs/2.1/customization/delimiter-processing.md
+++ b/docs/2.1/customization/delimiter-processing.md
@@ -2,7 +2,6 @@
layout: default
title: Delimiter Processing
description: Processing CommonMark delimiter runs with a custom processor
-redirect_from: /customization/delimiter-processing/
---
# Delimiter Processing
diff --git a/docs/2.1/customization/environment.md b/docs/2.1/customization/environment.md
index ea23f6254d..2bbf9db6be 100644
--- a/docs/2.1/customization/environment.md
+++ b/docs/2.1/customization/environment.md
@@ -2,7 +2,6 @@
layout: default
title: The Environment
description: Configuring the CommonMark environment with custom options and added functionality
-redirect_from: /customization/environment/
---
# The Environment
diff --git a/docs/2.1/customization/event-dispatcher.md b/docs/2.1/customization/event-dispatcher.md
index a523679914..7f25df972c 100644
--- a/docs/2.1/customization/event-dispatcher.md
+++ b/docs/2.1/customization/event-dispatcher.md
@@ -2,9 +2,6 @@
layout: default
title: Event Dispatcher
description: How to leverage the event dispatcher to hook into the library
-redirect_from:
-- /customization/document-processing/
-- /customization/event-dispatcher/
---
# Event Dispatcher
diff --git a/docs/2.1/customization/extensions.md b/docs/2.1/customization/extensions.md
index d6f15101ea..b501b81b36 100644
--- a/docs/2.1/customization/extensions.md
+++ b/docs/2.1/customization/extensions.md
@@ -2,7 +2,6 @@
layout: default
title: Extensions
description: Creating custom extensions to add new syntax and other custom functionality
-redirect_from: /customization/extensions/
---
# Extensions
diff --git a/docs/2.1/customization/inline-parsing.md b/docs/2.1/customization/inline-parsing.md
index c5363c9849..914f30c42a 100644
--- a/docs/2.1/customization/inline-parsing.md
+++ b/docs/2.1/customization/inline-parsing.md
@@ -2,7 +2,6 @@
layout: default
title: Inline Parsing
description: Parsing inline elements with a custom parser
-redirect_from: /customization/inline-parsing/
---
# Inline Parsing
diff --git a/docs/2.1/customization/overview.md b/docs/2.1/customization/overview.md
index a317be9f8c..44aee71b1a 100644
--- a/docs/2.1/customization/overview.md
+++ b/docs/2.1/customization/overview.md
@@ -2,9 +2,6 @@
layout: default
title: Customization Overview
description: An overview of the powerful customization features
-redirect_from:
-- /customization/
-- /customization/overview/
---
# Customization Overview
diff --git a/docs/2.1/customization/rendering.md b/docs/2.1/customization/rendering.md
index a4ec30d426..631ec4f00a 100644
--- a/docs/2.1/customization/rendering.md
+++ b/docs/2.1/customization/rendering.md
@@ -2,9 +2,6 @@
layout: default
title: Rendering
description: How to customize the rendering of block and inline elements
-redirect_from:
-- /customization/block-rendering/
-- /customization/inline-rendering/
---
# Custom Rendering
diff --git a/docs/2.1/customization/slug-normalizer.md b/docs/2.1/customization/slug-normalizer.md
index 6054e28172..d268301b9b 100644
--- a/docs/2.1/customization/slug-normalizer.md
+++ b/docs/2.1/customization/slug-normalizer.md
@@ -2,7 +2,6 @@
layout: default
title: Slug Normalizer
description: Using the Slug Normalizer to produce unique, URL-safe text strings
-redirect_from: /customization/slug-normalizer/
---
# Slug Normalizer
diff --git a/docs/2.1/extensions/attributes.md b/docs/2.1/extensions/attributes.md
index 1fbbd7c5e3..9cfeccbe12 100644
--- a/docs/2.1/extensions/attributes.md
+++ b/docs/2.1/extensions/attributes.md
@@ -2,7 +2,6 @@
layout: default
title: Attributes Extension
description: The AttributesExtension allows HTML attributes to be added from within the document.
-redirect_from: /extensions/attributes/
---
# Attributes
diff --git a/docs/2.1/extensions/autolinks.md b/docs/2.1/extensions/autolinks.md
index 7815d95ce8..87cb6cc9df 100644
--- a/docs/2.1/extensions/autolinks.md
+++ b/docs/2.1/extensions/autolinks.md
@@ -2,7 +2,6 @@
layout: default
title: Autolink Extension
description: The Autolink extension automatically converts URLs in plain text to clickable links
-redirect_from: /extensions/autolinks/
---
# Autolink Extension
diff --git a/docs/2.1/extensions/commonmark.md b/docs/2.1/extensions/commonmark.md
index ade8a1cef9..317a7ee79e 100644
--- a/docs/2.1/extensions/commonmark.md
+++ b/docs/2.1/extensions/commonmark.md
@@ -2,7 +2,6 @@
layout: default
title: CommonMark Core Extension
description: The CommonMarkCoreExtension class includes all core Markdown syntax
-redirect_from: /extensions/commonmark/
---
# CommonMark Core Extension
diff --git a/docs/2.1/extensions/default-attributes.md b/docs/2.1/extensions/default-attributes.md
index 169fef8ad3..62ef1b50a4 100644
--- a/docs/2.1/extensions/default-attributes.md
+++ b/docs/2.1/extensions/default-attributes.md
@@ -2,7 +2,6 @@
layout: default
title: Default Attributes Extension
description: The DefaultAttributesExtension allows you to apply default HTML classes and other attributes using configuration options.
-redirect_from: /extensions/default-attributes/
---
# Default Attributes
diff --git a/docs/2.1/extensions/description-lists.md b/docs/2.1/extensions/description-lists.md
index 197de4fc25..1e9927662c 100644
--- a/docs/2.1/extensions/description-lists.md
+++ b/docs/2.1/extensions/description-lists.md
@@ -2,7 +2,6 @@
layout: default
title: Description List Extension
description: The Description List extension adds support for Markdown Extra-style
lists
-redirect_from: /extensions/description-lists/
---
# Description List Extension
diff --git a/docs/2.1/extensions/disallowed-raw-html.md b/docs/2.1/extensions/disallowed-raw-html.md
index 7db19c2b7f..106d70ccd2 100644
--- a/docs/2.1/extensions/disallowed-raw-html.md
+++ b/docs/2.1/extensions/disallowed-raw-html.md
@@ -2,7 +2,6 @@
layout: default
title: Disallowed Raw HTML Extension
description: The DisallowedRawHtmlExtension automatically escapes certain HTML tags when rendering raw HTML
-redirect_from: /extensions/disallowed-raw-html/
---
# Disallowed Raw HTML Extension
diff --git a/docs/2.1/extensions/external-links.md b/docs/2.1/extensions/external-links.md
index 84c91f7b9b..de07c6eebf 100644
--- a/docs/2.1/extensions/external-links.md
+++ b/docs/2.1/extensions/external-links.md
@@ -2,7 +2,6 @@
layout: default
title: External Links Extension
description: The ExternalLinksExtension detects external links and adjusts their HTML markup
-redirect_from: /extensions/external-links/
---
# External Links Extension
diff --git a/docs/2.1/extensions/footnotes.md b/docs/2.1/extensions/footnotes.md
index 8f4a62732c..29b481af5d 100644
--- a/docs/2.1/extensions/footnotes.md
+++ b/docs/2.1/extensions/footnotes.md
@@ -2,7 +2,6 @@
layout: default
title: Footnote Extension
description: The FootnoteExtension adds the ability to create footnotes in Markdown documents.
-redirect_from: /extensions/footnotes/
---
# Footnotes
diff --git a/docs/2.1/extensions/front-matter.md b/docs/2.1/extensions/front-matter.md
index 8d8c7594ff..8477b8eddf 100644
--- a/docs/2.1/extensions/front-matter.md
+++ b/docs/2.1/extensions/front-matter.md
@@ -2,7 +2,6 @@
layout: default
title: Front Matter Extension
description: The Front Matter extension automatically parses YAML front matter from your Markdown.
-redirect_from: /extensions/front-matter/
---
# Front Matter Extension
diff --git a/docs/2.1/extensions/github-flavored-markdown.md b/docs/2.1/extensions/github-flavored-markdown.md
index c9a07929a6..9a4ee967f1 100644
--- a/docs/2.1/extensions/github-flavored-markdown.md
+++ b/docs/2.1/extensions/github-flavored-markdown.md
@@ -2,7 +2,6 @@
layout: default
title: GitHub-Flavored Markdown
description: The GithubFlavoredMarkdownExtension class includes all the GFM addons
-redirect_from: /extensions/github-flavored-markdown/
---
# GitHub-Flavored Markdown
diff --git a/docs/2.1/extensions/heading-permalinks.md b/docs/2.1/extensions/heading-permalinks.md
index 2057d1292e..9124b408d9 100644
--- a/docs/2.1/extensions/heading-permalinks.md
+++ b/docs/2.1/extensions/heading-permalinks.md
@@ -2,7 +2,6 @@
layout: default
title: Heading Permalink Extension
description: The HeadingPermalinkExtension makes all header elements linkable
-redirect_from: /extensions/heading-permalinks/
---
# Heading Permalink Extension
diff --git a/docs/2.1/extensions/inlines-only.md b/docs/2.1/extensions/inlines-only.md
index 67a61e3220..b21896cdcb 100644
--- a/docs/2.1/extensions/inlines-only.md
+++ b/docs/2.1/extensions/inlines-only.md
@@ -2,7 +2,6 @@
layout: default
title: Inlines Only Extension
description: The InlinesOnlyExtension only enables parsing of inline elements
-redirect_from: /extensions/inlines-only/
---
# Inlines Only Extension
diff --git a/docs/2.1/extensions/mentions.md b/docs/2.1/extensions/mentions.md
index b0bf9e6973..b4485c80bf 100644
--- a/docs/2.1/extensions/mentions.md
+++ b/docs/2.1/extensions/mentions.md
@@ -2,7 +2,6 @@
layout: default
title: Mention Parser
description: The MentionParser makes it easy to parse shortened references like @colinodell and #123 to custom URLs
-redirect_from: /extensions/mentions/
---
# Mention Extension
diff --git a/docs/2.1/extensions/overview.md b/docs/2.1/extensions/overview.md
index f9448e9789..75cb9af576 100644
--- a/docs/2.1/extensions/overview.md
+++ b/docs/2.1/extensions/overview.md
@@ -2,9 +2,6 @@
layout: default
title: Extensions Overview
description: An overview of the extensions included with this library
-redirect_from:
-- /extensions/
-- /extensions/overview/
---
# Extensions Overview
diff --git a/docs/2.1/extensions/smart-punctuation.md b/docs/2.1/extensions/smart-punctuation.md
index 12e212a3f8..d8d745c0ca 100644
--- a/docs/2.1/extensions/smart-punctuation.md
+++ b/docs/2.1/extensions/smart-punctuation.md
@@ -2,7 +2,6 @@
layout: default
title: Smart Punctuation Extension
description: The SmartPunctExtension intelligently converts ASCII quotes, dashes, and ellipses to their Unicode equivalents
-redirect_from: /extensions/smart-punctuation/
---
# Smart Punctuation Extension
diff --git a/docs/2.1/extensions/strikethrough.md b/docs/2.1/extensions/strikethrough.md
index b2cc78463b..35111012ac 100644
--- a/docs/2.1/extensions/strikethrough.md
+++ b/docs/2.1/extensions/strikethrough.md
@@ -2,7 +2,6 @@
layout: default
title: Strikethrough Extension
description: The StrikethroughExtension intelligently converts ASCII quotes, dashes, and ellipses to their Unicode equivalents
-redirect_from: /extensions/strikethrough/
---
# Strikethrough Extension
diff --git a/docs/2.1/extensions/table-of-contents.md b/docs/2.1/extensions/table-of-contents.md
index 7d8ddd6e6e..c093a85f8c 100644
--- a/docs/2.1/extensions/table-of-contents.md
+++ b/docs/2.1/extensions/table-of-contents.md
@@ -2,7 +2,6 @@
layout: default
title: Table of Contents Extension
description: The Table of Contents extension automatically inserts links to the headings in your document.
-redirect_from: /extensions/table-of-contents/
---
# Table of Contents Extension
diff --git a/docs/2.1/extensions/tables.md b/docs/2.1/extensions/tables.md
index c6fe58357b..46d3191a7a 100644
--- a/docs/2.1/extensions/tables.md
+++ b/docs/2.1/extensions/tables.md
@@ -2,7 +2,6 @@
layout: default
title: Table Extension
description: The TableExtension adds the ability to create tables in CommonMark documents
-redirect_from: /extensions/tables/
---
# Table Extension
diff --git a/docs/2.1/extensions/task-lists.md b/docs/2.1/extensions/task-lists.md
index d600cd1999..ab418e24ab 100644
--- a/docs/2.1/extensions/task-lists.md
+++ b/docs/2.1/extensions/task-lists.md
@@ -2,7 +2,6 @@
layout: default
title: Task List Extension
description: The TaskListExtension adds support for GFM-style task lists
-redirect_from: /extensions/task-lists/
---
# Task List Extension
diff --git a/docs/2.1/installation.md b/docs/2.1/installation.md
index e707b6fd67..91b1e473a3 100644
--- a/docs/2.1/installation.md
+++ b/docs/2.1/installation.md
@@ -2,7 +2,6 @@
layout: default
title: Installation
description: Instructions on how to install the league/commonmark library
-redirect_from: /installation/
---
# Installation
diff --git a/docs/2.1/security.md b/docs/2.1/security.md
index 468da6ef43..33b6b7d999 100644
--- a/docs/2.1/security.md
+++ b/docs/2.1/security.md
@@ -2,7 +2,6 @@
layout: default
title: Security
description: How to configure league/commonmark against possible security issues when handling untrusted user input
-redirect_from: /security/
---
# Security
diff --git a/docs/2.1/support.md b/docs/2.1/support.md
index 665d1ed69e..ada577ed22 100644
--- a/docs/2.1/support.md
+++ b/docs/2.1/support.md
@@ -2,7 +2,6 @@
layout: default
title: Support
description: Get help with the league/commonmark library
-redirect_from: /support/
---
# Support
diff --git a/docs/2.1/upgrading.md b/docs/2.1/upgrading.md
index b86a63a15a..04668057e2 100644
--- a/docs/2.1/upgrading.md
+++ b/docs/2.1/upgrading.md
@@ -2,7 +2,6 @@
layout: default
title: Upgrading from 2.0 to 2.1
description: Guide to upgrading to newer versions of this library
-redirect_from: /upgrading/
---
# Upgrading from 2.0 to 2.1
diff --git a/docs/2.1/xml.md b/docs/2.1/xml.md
index a3503dd784..3deb665283 100644
--- a/docs/2.1/xml.md
+++ b/docs/2.1/xml.md
@@ -2,7 +2,6 @@
layout: default
title: XML Rendering
description: Rendering Markdown documents in XML
-redirect_from: /xml/
---
# XML Rendering
diff --git a/docs/2.3/basic-usage.md b/docs/2.3/basic-usage.md
index 1163802ded..2d3f020ee5 100644
--- a/docs/2.3/basic-usage.md
+++ b/docs/2.3/basic-usage.md
@@ -2,6 +2,7 @@
layout: default
title: Basic Usage
description: Basic usage of the CommonMark parser
+redirect_from: /basic-usage/
---
# Basic Usage
diff --git a/docs/2.3/changelog.md b/docs/2.3/changelog.md
index bd8998792b..4888150372 100644
--- a/docs/2.3/changelog.md
+++ b/docs/2.3/changelog.md
@@ -2,6 +2,7 @@
layout: default
title: Changelog
description: Important changes made in recent releases
+redirect_from: /changelog/
---
# Changelog
diff --git a/docs/2.3/configuration.md b/docs/2.3/configuration.md
index 479c54d957..2740b5e76b 100644
--- a/docs/2.3/configuration.md
+++ b/docs/2.3/configuration.md
@@ -1,6 +1,7 @@
---
layout: default
title: Configuration
+redirect_from: /configuration/
---
# Configuration
diff --git a/docs/2.3/customization/abstract-syntax-tree.md b/docs/2.3/customization/abstract-syntax-tree.md
index 595e10016f..acf7cbd3d5 100644
--- a/docs/2.3/customization/abstract-syntax-tree.md
+++ b/docs/2.3/customization/abstract-syntax-tree.md
@@ -2,6 +2,7 @@
layout: default
title: Abstract Syntax Tree
description: Using the Abstract Syntax Tree (AST) to manipulate the parsed content
+redirect_from: /customization/abstract-syntax-tree/
---
# Abstract Syntax Tree
diff --git a/docs/2.3/customization/block-parsing.md b/docs/2.3/customization/block-parsing.md
index 6e1b91e808..b9637d1a4d 100644
--- a/docs/2.3/customization/block-parsing.md
+++ b/docs/2.3/customization/block-parsing.md
@@ -2,6 +2,7 @@
layout: default
title: Block Parsing
description: How to parse block-level elements
+redirect_from: /customization/block-parsing/
---
# Block Parsing
diff --git a/docs/2.3/customization/configuration.md b/docs/2.3/customization/configuration.md
index e7cbe1cbf3..89825b5093 100644
--- a/docs/2.3/customization/configuration.md
+++ b/docs/2.3/customization/configuration.md
@@ -2,6 +2,7 @@
layout: default
title: Configuration
description: Defining configuration schemas and accessing user-provided configuration options within your custom extensions
+redirect_from: /customization/configuration/
---
# Configuration Schemas and Values
diff --git a/docs/2.3/customization/cursor.md b/docs/2.3/customization/cursor.md
index 01e1a016ee..27860c44b0 100644
--- a/docs/2.3/customization/cursor.md
+++ b/docs/2.3/customization/cursor.md
@@ -2,6 +2,7 @@
layout: default
title: Cursor
description: Using the Cursor object to parse Markdown content
+redirect_from: /customization/cursor/
---
# Cursor
diff --git a/docs/2.3/customization/delimiter-processing.md b/docs/2.3/customization/delimiter-processing.md
index ec2c354da7..f1d4fe1fe6 100644
--- a/docs/2.3/customization/delimiter-processing.md
+++ b/docs/2.3/customization/delimiter-processing.md
@@ -2,6 +2,7 @@
layout: default
title: Delimiter Processing
description: Processing CommonMark delimiter runs with a custom processor
+redirect_from: /customization/delimiter-processing/
---
# Delimiter Processing
diff --git a/docs/2.3/customization/environment.md b/docs/2.3/customization/environment.md
index 9b30d14a7a..68ba1300ef 100644
--- a/docs/2.3/customization/environment.md
+++ b/docs/2.3/customization/environment.md
@@ -2,6 +2,7 @@
layout: default
title: The Environment
description: Configuring the CommonMark environment with custom options and added functionality
+redirect_from: /customization/environment/
---
# The Environment
diff --git a/docs/2.3/customization/event-dispatcher.md b/docs/2.3/customization/event-dispatcher.md
index 78915e40e2..f98935362b 100644
--- a/docs/2.3/customization/event-dispatcher.md
+++ b/docs/2.3/customization/event-dispatcher.md
@@ -2,6 +2,9 @@
layout: default
title: Event Dispatcher
description: How to leverage the event dispatcher to hook into the library
+redirect_from:
+- /customization/document-processing/
+- /customization/event-dispatcher/
---
# Event Dispatcher
diff --git a/docs/2.3/customization/extensions.md b/docs/2.3/customization/extensions.md
index 9c15c0b3ea..d92a2eabe8 100644
--- a/docs/2.3/customization/extensions.md
+++ b/docs/2.3/customization/extensions.md
@@ -2,6 +2,7 @@
layout: default
title: Extensions
description: Creating custom extensions to add new syntax and other custom functionality
+redirect_from: /customization/extensions/
---
# Extensions
diff --git a/docs/2.3/customization/inline-parsing.md b/docs/2.3/customization/inline-parsing.md
index 6f23a1a9a7..e4f98e2a5c 100644
--- a/docs/2.3/customization/inline-parsing.md
+++ b/docs/2.3/customization/inline-parsing.md
@@ -2,6 +2,7 @@
layout: default
title: Inline Parsing
description: Parsing inline elements with a custom parser
+redirect_from: /customization/inline-parsing/
---
# Inline Parsing
diff --git a/docs/2.3/customization/overview.md b/docs/2.3/customization/overview.md
index 77e5d41cab..9b5ca22892 100644
--- a/docs/2.3/customization/overview.md
+++ b/docs/2.3/customization/overview.md
@@ -2,6 +2,9 @@
layout: default
title: Customization Overview
description: An overview of the powerful customization features
+redirect_from:
+- /customization/
+- /customization/overview/
---
# Customization Overview
diff --git a/docs/2.3/customization/rendering.md b/docs/2.3/customization/rendering.md
index cff6c5aa95..e49e1cafba 100644
--- a/docs/2.3/customization/rendering.md
+++ b/docs/2.3/customization/rendering.md
@@ -2,6 +2,9 @@
layout: default
title: Rendering
description: How to customize the rendering of block and inline elements
+redirect_from:
+- /customization/block-rendering/
+- /customization/inline-rendering/
---
# Custom Rendering
diff --git a/docs/2.3/customization/slug-normalizer.md b/docs/2.3/customization/slug-normalizer.md
index d268301b9b..6054e28172 100644
--- a/docs/2.3/customization/slug-normalizer.md
+++ b/docs/2.3/customization/slug-normalizer.md
@@ -2,6 +2,7 @@
layout: default
title: Slug Normalizer
description: Using the Slug Normalizer to produce unique, URL-safe text strings
+redirect_from: /customization/slug-normalizer/
---
# Slug Normalizer
diff --git a/docs/2.3/extensions/attributes.md b/docs/2.3/extensions/attributes.md
index 63b39bec87..1169ae283b 100644
--- a/docs/2.3/extensions/attributes.md
+++ b/docs/2.3/extensions/attributes.md
@@ -2,6 +2,7 @@
layout: default
title: Attributes Extension
description: The AttributesExtension allows HTML attributes to be added from within the document.
+redirect_from: /extensions/attributes/
---
# Attributes
diff --git a/docs/2.3/extensions/autolinks.md b/docs/2.3/extensions/autolinks.md
index 6ffda434f5..bb4ede2f6e 100644
--- a/docs/2.3/extensions/autolinks.md
+++ b/docs/2.3/extensions/autolinks.md
@@ -2,6 +2,7 @@
layout: default
title: Autolink Extension
description: The Autolink extension automatically converts URLs in plain text to clickable links
+redirect_from: /extensions/autolinks/
---
# Autolink Extension
diff --git a/docs/2.3/extensions/commonmark.md b/docs/2.3/extensions/commonmark.md
index aa442f745c..337208f763 100644
--- a/docs/2.3/extensions/commonmark.md
+++ b/docs/2.3/extensions/commonmark.md
@@ -2,6 +2,7 @@
layout: default
title: CommonMark Core Extension
description: The CommonMarkCoreExtension class includes all core Markdown syntax
+redirect_from: /extensions/commonmark/
---
# CommonMark Core Extension
diff --git a/docs/2.3/extensions/default-attributes.md b/docs/2.3/extensions/default-attributes.md
index a46cbddb17..94fa3b08f1 100644
--- a/docs/2.3/extensions/default-attributes.md
+++ b/docs/2.3/extensions/default-attributes.md
@@ -2,6 +2,7 @@
layout: default
title: Default Attributes Extension
description: The DefaultAttributesExtension allows you to apply default HTML classes and other attributes using configuration options.
+redirect_from: /extensions/default-attributes/
---
# Default Attributes
diff --git a/docs/2.3/extensions/description-lists.md b/docs/2.3/extensions/description-lists.md
index 66d63cebdf..a1a6e1d517 100644
--- a/docs/2.3/extensions/description-lists.md
+++ b/docs/2.3/extensions/description-lists.md
@@ -2,6 +2,7 @@
layout: default
title: Description List Extension
description: The Description List extension adds support for Markdown Extra-style lists
+redirect_from: /extensions/description-lists/
---
# Description List Extension
diff --git a/docs/2.3/extensions/disallowed-raw-html.md b/docs/2.3/extensions/disallowed-raw-html.md
index ffdd73c6f3..5bd19e4aec 100644
--- a/docs/2.3/extensions/disallowed-raw-html.md
+++ b/docs/2.3/extensions/disallowed-raw-html.md
@@ -2,6 +2,7 @@
layout: default
title: Disallowed Raw HTML Extension
description: The DisallowedRawHtmlExtension automatically escapes certain HTML tags when rendering raw HTML
+redirect_from: /extensions/disallowed-raw-html/
---
# Disallowed Raw HTML Extension
diff --git a/docs/2.3/extensions/embed.md b/docs/2.3/extensions/embed.md
index 517ea67e69..6d34b6f62a 100644
--- a/docs/2.3/extensions/embed.md
+++ b/docs/2.3/extensions/embed.md
@@ -2,6 +2,7 @@
layout: default
title: Embed Extension
description: The EmbedExtension supports embedding rich content from other websites.
+redirect_from: /extensions/embed/
---
# Embed Extension
diff --git a/docs/2.3/extensions/external-links.md b/docs/2.3/extensions/external-links.md
index 0dab8a3f62..42ea50d9f6 100644
--- a/docs/2.3/extensions/external-links.md
+++ b/docs/2.3/extensions/external-links.md
@@ -2,6 +2,7 @@
layout: default
title: External Links Extension
description: The ExternalLinksExtension detects external links and adjusts their HTML markup
+redirect_from: /extensions/external-links/
---
# External Links Extension
diff --git a/docs/2.3/extensions/footnotes.md b/docs/2.3/extensions/footnotes.md
index e46861ae54..190318c756 100644
--- a/docs/2.3/extensions/footnotes.md
+++ b/docs/2.3/extensions/footnotes.md
@@ -2,6 +2,7 @@
layout: default
title: Footnote Extension
description: The FootnoteExtension adds the ability to create footnotes in Markdown documents.
+redirect_from: /extensions/footnotes/
---
# Footnotes
diff --git a/docs/2.3/extensions/front-matter.md b/docs/2.3/extensions/front-matter.md
index 9cb48a27ae..83b99a4a9a 100644
--- a/docs/2.3/extensions/front-matter.md
+++ b/docs/2.3/extensions/front-matter.md
@@ -2,6 +2,7 @@
layout: default
title: Front Matter Extension
description: The Front Matter extension automatically parses YAML front matter from your Markdown.
+redirect_from: /extensions/front-matter/
---
# Front Matter Extension
diff --git a/docs/2.3/extensions/github-flavored-markdown.md b/docs/2.3/extensions/github-flavored-markdown.md
index ae9e467a5e..29072fe06c 100644
--- a/docs/2.3/extensions/github-flavored-markdown.md
+++ b/docs/2.3/extensions/github-flavored-markdown.md
@@ -2,6 +2,7 @@
layout: default
title: GitHub-Flavored Markdown
description: The GithubFlavoredMarkdownExtension class includes all the GFM addons
+redirect_from: /extensions/github-flavored-markdown/
---
# GitHub-Flavored Markdown
diff --git a/docs/2.3/extensions/heading-permalinks.md b/docs/2.3/extensions/heading-permalinks.md
index 3ba6673b21..937fc5c2f8 100644
--- a/docs/2.3/extensions/heading-permalinks.md
+++ b/docs/2.3/extensions/heading-permalinks.md
@@ -2,6 +2,7 @@
layout: default
title: Heading Permalink Extension
description: The HeadingPermalinkExtension makes all header elements linkable
+redirect_from: /extensions/heading-permalinks/
---
# Heading Permalink Extension
diff --git a/docs/2.3/extensions/inlines-only.md b/docs/2.3/extensions/inlines-only.md
index a91f657011..0dae1415d4 100644
--- a/docs/2.3/extensions/inlines-only.md
+++ b/docs/2.3/extensions/inlines-only.md
@@ -2,6 +2,7 @@
layout: default
title: Inlines Only Extension
description: The InlinesOnlyExtension only enables parsing of inline elements
+redirect_from: /extensions/inlines-only/
---
# Inlines Only Extension
diff --git a/docs/2.3/extensions/mentions.md b/docs/2.3/extensions/mentions.md
index f17c0a42d9..3502d0c239 100644
--- a/docs/2.3/extensions/mentions.md
+++ b/docs/2.3/extensions/mentions.md
@@ -2,6 +2,7 @@
layout: default
title: Mention Parser
description: The MentionParser makes it easy to parse shortened references like @colinodell and #123 to custom URLs
+redirect_from: /extensions/mentions/
---
# Mention Extension
diff --git a/docs/2.3/extensions/overview.md b/docs/2.3/extensions/overview.md
index 8000d77e48..20837110bf 100644
--- a/docs/2.3/extensions/overview.md
+++ b/docs/2.3/extensions/overview.md
@@ -2,6 +2,9 @@
layout: default
title: Extensions Overview
description: An overview of the extensions included with this library
+redirect_from:
+- /extensions/
+- /extensions/overview/
---
# Extensions Overview
diff --git a/docs/2.3/extensions/smart-punctuation.md b/docs/2.3/extensions/smart-punctuation.md
index 1fc9a63632..88aa18e1ca 100644
--- a/docs/2.3/extensions/smart-punctuation.md
+++ b/docs/2.3/extensions/smart-punctuation.md
@@ -2,6 +2,7 @@
layout: default
title: Smart Punctuation Extension
description: The SmartPunctExtension intelligently converts ASCII quotes, dashes, and ellipses to their Unicode equivalents
+redirect_from: /extensions/smart-punctuation/
---
# Smart Punctuation Extension
diff --git a/docs/2.3/extensions/strikethrough.md b/docs/2.3/extensions/strikethrough.md
index 856efea980..df3fe568a0 100644
--- a/docs/2.3/extensions/strikethrough.md
+++ b/docs/2.3/extensions/strikethrough.md
@@ -2,6 +2,7 @@
layout: default
title: Strikethrough Extension
description: The StrikethroughExtension intelligently converts ASCII quotes, dashes, and ellipses to their Unicode equivalents
+redirect_from: /extensions/strikethrough/
---
# Strikethrough Extension
diff --git a/docs/2.3/extensions/table-of-contents.md b/docs/2.3/extensions/table-of-contents.md
index 14e3b1d43d..0ce69cbd38 100644
--- a/docs/2.3/extensions/table-of-contents.md
+++ b/docs/2.3/extensions/table-of-contents.md
@@ -2,6 +2,7 @@
layout: default
title: Table of Contents Extension
description: The Table of Contents extension automatically inserts links to the headings in your document.
+redirect_from: /extensions/table-of-contents/
---
# Table of Contents Extension
diff --git a/docs/2.3/extensions/tables.md b/docs/2.3/extensions/tables.md
index bb5f1abc89..2318ab8722 100644
--- a/docs/2.3/extensions/tables.md
+++ b/docs/2.3/extensions/tables.md
@@ -2,6 +2,7 @@
layout: default
title: Table Extension
description: The TableExtension adds the ability to create tables in CommonMark documents
+redirect_from: /extensions/tables/
---
# Table Extension
diff --git a/docs/2.3/extensions/task-lists.md b/docs/2.3/extensions/task-lists.md
index 39f1834f40..588ba35af0 100644
--- a/docs/2.3/extensions/task-lists.md
+++ b/docs/2.3/extensions/task-lists.md
@@ -2,6 +2,7 @@
layout: default
title: Task List Extension
description: The TaskListExtension adds support for GFM-style task lists
+redirect_from: /extensions/task-lists/
---
# Task List Extension
diff --git a/docs/2.3/installation.md b/docs/2.3/installation.md
index effe16973d..3cf657eff9 100644
--- a/docs/2.3/installation.md
+++ b/docs/2.3/installation.md
@@ -2,6 +2,7 @@
layout: default
title: Installation
description: Instructions on how to install the league/commonmark library
+redirect_from: /installation/
---
# Installation
diff --git a/docs/2.3/security.md b/docs/2.3/security.md
index caf37094ab..97fe1c217f 100644
--- a/docs/2.3/security.md
+++ b/docs/2.3/security.md
@@ -2,6 +2,7 @@
layout: default
title: Security
description: How to configure league/commonmark against possible security issues when handling untrusted user input
+redirect_from: /security/
---
# Security
diff --git a/docs/2.3/support.md b/docs/2.3/support.md
index 6531f9dbbc..8772e1de29 100644
--- a/docs/2.3/support.md
+++ b/docs/2.3/support.md
@@ -2,6 +2,7 @@
layout: default
title: Support
description: Get help with the league/commonmark library
+redirect_from: /support/
---
# Support
diff --git a/docs/2.3/upgrading.md b/docs/2.3/upgrading.md
index 81b411a471..3c278213c1 100644
--- a/docs/2.3/upgrading.md
+++ b/docs/2.3/upgrading.md
@@ -2,6 +2,11 @@
layout: default
title: Upgrading from 2.2 to 2.3
description: Guide to upgrading to newer versions of this library
+redirect_from: /upgrading/
---
# Upgrading from 2.2 to 2.3
+
+## Avoid deprecated interface
+
+`MarkdownRendererInterface` has been deprecated and will be removed in the next major version. Please use `DocumentRendererInterface` instead.
diff --git a/docs/2.3/xml.md b/docs/2.3/xml.md
index 7fad850e25..a654cff0ec 100644
--- a/docs/2.3/xml.md
+++ b/docs/2.3/xml.md
@@ -2,6 +2,7 @@
layout: default
title: XML Rendering
description: Rendering Markdown documents in XML
+redirect_from: /xml/
---
# XML Rendering
diff --git a/docs/_data/project.yml b/docs/_data/project.yml
index 5cd2007579..281959ea69 100644
--- a/docs/_data/project.yml
+++ b/docs/_data/project.yml
@@ -4,22 +4,21 @@ description: PHP Markdown parser featuring support for CommonMark, GFM, and cust
site_title: CommonMark for PHP
google_analytics_tracking_id: UA-137970568-1
repository: commonmark
-default_version: '2.2'
+default_version: '2.3'
releases:
- next:
+ current:
'2.3':
documentation_link: '/2.3/'
- current:
+ previous:
'2.2':
documentation_link: '/2.2/'
- previous:
'2.1':
documentation_link: '/2.1/'
+ legacy:
'2.0':
documentation_link: '/2.0/'
'1.6':
documentation_link: '/1.6/'
- legacy:
'1.5':
documentation_link: '/1.5/'
'1.4':