Draft release notes and doc updates for 2.0.0 release

Created on 3 August 2025, 9 days ago

The 2.0.0 version will require solid release notes and some (mostly already done) documentation updates. I'll use this issue to keep track of everything.

📌 Remove/lesson dependency on "Convert line breaks into HTML" Active

  • Documentation updated - see https://www.drupal.org/docs/extending-drupal/contributed-modules/contrib...
  • README.md updated (as part of this issue's MR.)
  • Release notes text: This version drops the requirement that the "Convert line breaks into HTML" text filter be enabled when using the Markdown Easy text filter. When upgrading from the 1.x branch, you can either choose to keep the "Convert line breaks into HTML" text filter enabled or you can disable it and add <p> and <br> to the list of tags in the "Limit allowed HTML tags and correct faulty HTML" filter configuration.

📌 Improve interaction with HTML filter Active

  • No documentation updates necessary.
  • No README.md updates necessary.
  • Release notes text: This version improves the feedback provided to site builders regarding the recommended tags for the "Limit allowed HTML tags and correct faulty HTML" filter depending on the Markdown Easy flavor selected.

Create new "power user" flag to disable warnings and validation Active

📌 Convert "tips" to an "item_list" Active

  • No documentation updates necessary.
  • No README.md updates necessary.
  • Release notes text: Improves the help text provided when configuring the Markdown Easy text filter.
📌 Task
Status

Active

Version

2.0

Component

Documentation

Created by

🇺🇸United States ultimike Florida, USA

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

  • Issue created by @ultimike
  • 🇺🇸United States ultimike Florida, USA
  • 🇺🇸United States ultimike Florida, USA
  • 🇺🇸United States ultimike Florida, USA
  • 🇺🇸United States ultimike Florida, USA
  • 🇺🇸United States ultimike Florida, USA
  • 🇮🇪Ireland lostcarpark

    This all looks solid to me. We might also add 📌 Doublecheck settings being merged Active , which is all code removal, so I don't think needs any documentation or Readme change, but might need a brief note in the release notes, something like:

    • Removed merge of saved settings with default when loading form, also removed blank "tips" from schema, and removed use of "Convert line breaks" filter from some tests.
  • 🇺🇸United States ultimike Florida, USA
  • 🇺🇸United States ultimike Florida, USA

    I just added some info about changes to the project page as well.

    @lostcarpark - good idea in your comment 8, I'll add that as well. Okay to RTBC then?

    thanks,
    -mike

  • 🇮🇪Ireland lostcarpark

    Yes. Moving to RTBC on the assumption of that addition.

  • 🇮🇪Ireland lostcarpark

    And the project page changes look good to me.

  • Pipeline finished with Skipped
    9 days ago
    #564300
    • ultimike committed 5f164507 on 2.0.x
      Issue #3539479 by ultimike, lostcarpark: Draft release notes and doc...
  • 🇺🇸United States ultimike Florida, USA

    Thanks - merged.

    -mike

  • 🇺🇸United States ultimike Florida, USA

    Actually, I'm going to leave this issue open as once the 2.0.0 release is made, I'll need to update the project page with the changes listed above.

    -mike

  • 🇺🇸United States ultimike Florida, USA

    Added info about the breaking change from the hook implementation update!

  • 🇺🇸United States ultimike Florida, USA

    Added reference to markdown_easy.api.php file.

  • 🇧🇪Belgium Dries

    To help test RC1, I upgraded to Markdown Easy 2.0-RC1. I'll share my steps here, in case they are helpful for documentation purposes.

    Upgrade the module from your current version to 2.0-RC1:

    ddev composer require 'drupal/markdown_easy:^2.0@RC'

    Run the database updates:

    ddev drush updatedb

    Enable the new 2.0 settings for filter enforcement and HTML stripping:

    ddev drush config:set markdown_easy.settings skip_filter_enforcement 1

    When prompted "markdown_easy.settings config does not exist. Do you want to create a new config object?", select "Yes".

    Configure HTML input stripping:

    ddev drush config:set markdown_easy.settings skip_html_input_stripping 1

    Again, select "Yes" when prompted.

    Security note: Skipping filter enforcement and HTML input stripping may have security implications. Only enable these settings if you trust your content sources and know what you're doing.

    Verified my settings:

    ddev drush config:get markdown_easy.settings
    

    You should see:

    skip_filter_enforcement: true
    skip_html_input_stripping: true

    Clear cache to clear content caches:

    ddev drush cache-rebuild

    Next, I updated my existing Markdown text format. I went to /admin/config/content/formats/ and make the following changes:

    • I set the Markdown flavor to "Smorgasbord"
    • Disabled "Limit allowed HTML tags and correct faulty HTML"
    • Disabled "Convert line breaks into HTML (i.e.
      and

      )"

    Then saved the text format configuration. So far, everything seems to work fine on my development environment.

Production build 0.71.5 2024