league/commonmark 2.0.0 Released!

Written by - Blog / Original link on Jul. 24, 2021

After 96 releases, 368 pull requests, and over 48 million downloads, I'm pleased to share that the next major version of league/commonmark 2.0.0 stable is now generally available! 🎉🎉

You can install the latest version via Composer:

composer require league/commonmark:^2.0

What's new in 2.0?

There's so much to cover, but here are the key improvements and changes:

Upgrading from 1.x

The upgrade process will vary based on whether you have custom functionality or are simply using the library as-is. I've therefore split the upgrading guide into three parts to help you understand the changes that impact you:

The Future of 1.x

Per the usual policies, the 1.6 branch will continue to receive bug fixes for at least 3 months and security updates for 6 months, if not longer, depending on the severity of any issues. No further minor releases (like 1.7.0) will be made, meaning that all new features and spec compliance updates will only be added to 2.0 and higher. You are therefore strongly encouraged to upgrade to the new version if/when you can.

If for any reason you can't upgrade immediately, that's alright - 1.6 is very stable and should work just fine until you're able to upgrade. And of course, if you're stuck on an older version of PHP you can keep using 1.6 too.

If you're using Laravel, note that support for league/commonmark v1 is being dropped in Larvel 9. Other frameworks and integrations will also like drop 1.x support from new major releases over the rest of this year.

Roadmap for 2.1 and 3.0

You didn't think development was over now that 2.0.0 is released, did you? We're already planning some exciting new features for future versions:

Coming in 2.1

Coming in 3.0

(The features above are subject to change)

Thank You

I owe a huge debt of thanks to everyone who helped make this possible, including (in no particular order):


« Watch as fireman cat rescues cat stuck in a tree - A Week of Symfony #760 (19-25 July 2021) »