chore: update markdownlint

[dsanders11]

Description of Change

Updates markdownlint so we can use new linting rules, but disables most of them for now - I'll enable them and clean up violations in future PRs.

This will run clean once #36519 is merged.

Checklist

• PR description included and stakeholders cc'd

Release Notes

Notes: none

[release-clerk]

No Release Notes

[DavidAnson]

FYI, based on the way this project appears to be using the markdownlint-cli package, it should NOT need to directly reference the markdownlint package in package.json because that's a dependency of the CLI.

Unrelated, you MAY find markdownlint-cli2 a little faster - if not, I'd love to know so I can look into why. :)

/cc @dsanders11

[dsanders11]

Hi @DavidAnson, thanks for dropping by!

FYI, based on the way this project appears to be using the markdownlint-cli package, it should NOT need to directly reference the markdownlint package in package.json because that's a dependency of the CLI.

You're right, I noticed that was odd when doing this PR, but didn't have time to dig further into it. 🙂 I'm sure it's a mistake I made when I first added markdownlint-cli - I think originally I was toying with using it programmatically but went with markdownlint-cli instead and just didn't clean up package.json properly.

Unrelated, you MAY find markdownlint-cli2 a little faster - if not, I'd love to know so I can look into why. :)

On my machine it takes 1s to do the linting so I'm not sure I'd notice the speed up. 😅 If I get some time in the future I'll take a look at markdownlint-cli2, but I've got a roadmap of other things to do to help keep the Markdown files in this repo in good shape so it may be a bit. 🙂 Feel free to chime in on that issue if you have any insights, I know markdownlint-cli might be able to help with more of that in the future.