Note about preserving data in HTML transformation

[rawnsley]

Initial checklist

• I read the support docs
• I read the contributing guide
• I agree to follow the code of conduct
• I searched issues and discussions and couldn’t find anything or linked relevant results below
• I made sure the docs are up to date
• I included tests (or that’s not needed)

Description of changes

Added a note about how to transform Markdown directives to HTML. It took me some searching to find remark-directive-rehype and it feels like adding ids classes and attributes to HTML output is an important use case for this library; possibly even the primary use case.

[wooorm]

it feels like adding ids classes and attributes to HTML output is an important use case for this library

That seems like the Use example?

I am not sure how much this adds compared to the existing examples/

Perhaps this plugin can go in “Related”?

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (e1027d1) to head (185b5c7).
Report is 16 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main       #23   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            2         2           
  Lines           40        40           
=========================================
  Hits            40        40           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[rawnsley]

@wooorm Moved to "Related" as suggested. Regarding how much it adds: I think an example of how to transform to HTML without writing your own custom transformer is valuable.

[wooorm]

It is quite intentional that unified pushes people to make plugins, learn about ASTs!