Html To Markdown Laravel Package

This is a security release. All users who convert HTML they don't fully control should upgrade.

Security

• Fixed the time taken to convert a document growing with the square of the number of elements sharing a parent, rather than in proportion to it (GHSA-h3wg-gqjr-jjmw). This affected list items, <pre>, <code>, table rows and cells and preserved HTML tags on every version of PHP, and all other elements on older versions of PHP (seen on 8.0 and below).

This fix does not change the Markdown which is output.

Full Changelog: https://github.com/thephpleague/html-to-markdown/compare/5.1.3...5.1.4

Notable Changes

• fix: honor start="0" on ordered lists by @dualfroz in https://github.com/thephpleague/html-to-markdown/pull/277
• Fix README.md example by @alamirault in https://github.com/thephpleague/html-to-markdown/pull/251
• Test against PHP 8.2-8.5 and PHPUnit 10-13 by @colinodell in https://github.com/thephpleague/html-to-markdown/pull/275
• Run PHPStan 2 in CI, targeting the oldest supported PHP by @colinodell in https://github.com/thephpleague/html-to-markdown/pull/276

New Contributors

• @alamirault made their first contribution in https://github.com/thephpleague/html-to-markdown/pull/251
• @dualfroz made their first contribution in https://github.com/thephpleague/html-to-markdown/pull/277

Full Changelog: https://github.com/thephpleague/html-to-markdown/compare/5.1.1...5.1.2

Fixed

• Fixed <pre> tags with attributes not being parsed (#215, #238)
• Fixed missing type checks and coercions

Changed

• Changed horizontal rule style (#218, #219)

Fixed

• Fixed Element::getValue() not handling possible nulls

Fixed

• Fixed missplaced comment nodes appearing at the start of the HTML input (#212)

Fixed

• Fixed lists not using the correct amount of indentation (#211)

Added

• Added support for tables (#203)
  • This feature is disable by default - see README for how to enable it
• Added new strip_placeholder_links option to strip <a> tags without href attributes (#196)
• Added new methods to ElementInterface:
  • hasParent()
  • getNextSibling()
  • getPreviousSibling()
  • getListItemLevel()
• Added several parameter and return types across all classes
• Added new PreConverterInterface to allow converters to perform any necessary pre-parsing

Changed

• Supported PHP versions increased to PHP 7.2 - 8.0
• HtmlConverter::convert() may now throw a \RuntimeException when unexpected DOMDocument-related errors occur

Fixed

• Fixed complex nested lists containing heading and paragraphs (#198)
• Fixed consecutive emphasis producing incorrect markdown (#202)

Added

• Added the ability to disable autolinking with a configuration option (#187, #188)

Fixed

• Fixed issue with HTML entity escaping in text (#184)

Added

• Added new option to preserve comments (#177, #179)

Fixed

• Fixed whitespace preservation around <code> tags (#174, #178)

Fixed

• Fixed headers not being placed onto a new line in some cases (#172)
• Fixed handling of links containing spaces (#175)

Removed

• Removed support for HHVM

Added

• Added support for PHP 7.3 :tada:

Fixed

• Fixed paragraphs following tables (#165, #166)
• Fixed incorrect list item escaping (#168, #169)

Added

• Added support for email auto-linking
• Added a new interface (HtmlConverterInterface) for the main HtmlConverter class
• Added additional test cases (#14)

Changed

• The italic_style option now defaults to '*' so that in-word emphasis is handled properly (#75)

Fixed

• Fixed several issues of <code> and <pre> tags not converting to blocks or inlines properly (#26, #70, #102, #140, #161, #162)
• Fixed in-word emphasis using underscores as delimiter (#75)
• Fixed character escaping inside of <div> elements
• Fixed header edge cases

Deprecated

• The bold_style and italic_style options have been deprecated (#75)

Added

• Added setOptions() function for chainable calling (#149)
• Added new list_item_style_alternate option for converting every-other list with a different character (#155)

Fixed

• Fixed insufficient newlines after code blocks (#144, #148)
• Fixed trailing spaces not being preserved in link anchors (#157)
• Fixed list-like lines not being escaped inside of lists items (#159)

Fixed

• Fixed issue with emphasized spaces (#146)

Fixed

• Fixed conversion of <pre> tags (#145)

Added

• Added support for ordered lists starting at numbers other than 1

Fixed

• Fixed overly-eager escaping of list-like text (#141)

Added

• Added configuration option for list item style (#135, #136)

Fixed

• Fixed autolinking of invalid URLs (#129)

Added

• Added hard_break configuration option (#112, #115)
• The HtmlConverter can now be instantiated with an Environment (#118)

Fixed

• Fixed handling of paragraphs in list item elements (#47, #110)
• Fixed phantom spaces when newlines follow br elements (#116, #117)
• Fixed link converter not sanitizing inner spaces properly (#119, #120)

Changed

• Revised the sanitization implementation (#109)

Fixed

• Fixed tag-like content not being escaped (#67, #109)
• Fixed thematic break-like content not being escaped (#65, #109)
• Fixed codefence-like content not being escaped (#64, #109)

Added

• Added full support for PHP 7.0 and 7.1

Changed

• Changed <pre> and <pre><code> conversions to use backticks instead of indendation (#102)

Fixed

• Fixed issue where specified code language was not preserved (#70, #102)
• Fixed issue where <code> tags nested in <pre> was not converted properly (#70, #102)
• Fixed header-like content not being escaped (#76, #105)
• Fixed blockquote-like content not being escaped (#77, #103)
• Fixed ordered list-like content not being escaped (#73, #106)
• Fixed unordered list-like content not being escaped (#71, #107)

Fixed

• Fixed sanitization bug which sometimes removes desired content (#63, #101)

Fixed

• Fixed path to autoload.php when used as a library (#98)
• Fixed edge case for tags containing only whitespace (#99)

Removed

• Removed double HTML entity decoding, as this is not desireable (#60)

Added

• Added the ability to invoke HtmlConverter objects as functions (#85)

Fixed

• Fixed improper handling of nested list items (#19 and #84)
• Fixed preceeding or trailing spaces within emphasis tags (#83)

Fixed

• Fixed conversion of empty paragraphs (#78)
• Fixed preg_replace so it wouldn't break UTF-8 characters (#79)

This release adds a new CLI converter!

Added

• Added bin/html-to-markdown script

Changed

• Changed default italic character to _ (#58)

Fixed

• Added escaping to avoid * and _ in a text being rendered as emphasis (#48)

Removed

• Removed the demo (#51)
• .styleci.yml and CONTRIBUTING.md are no longer included in distributions (#50)

This release changes the visibility of several methods/properties. #42 and #43 brought to light that some visiblities were not ideally set, so this releases fixes that. Moving forwards this should reduce the chance of introducing BC-breaking changes.

Added

• Added new HtmlConverter::getEnvironment() method to expose the Environment (#42, #43)

Changed

• Changed Environment::addConverter() from protected to public, enabling custom converters to be added (#42, #43)
• Changed HtmlConverter::createDOMDocument() from protected to private
• Changed Element::nextCached from protected to private
• Made the Environment class final

Fixed

• Empty HTML strings now result in empty Markdown documents (#40, #41)

Added

• Added new equals method to Element to check for equality

Changes

• Use Linux line endings consistently instead of plaform-specific line endings (#36)

Fixed

• Cleaned up code style