Solve some markdownlint issues

[mgovers]

• add markdownlint to VSCode workspace recommendations

Resolve the following markdownlint issues:

• MD033/no-inline-html : Inline HTML : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md033.md
• MD040/fenced-code-language : Fenced code blocks should have a language specified : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md040.md
• MD041/first-line-heading/first-line-h1 : First line in a file should be a top-level heading : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md041.md
• MD042/no-empty-links : No empty links : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md042.md
• MD045/no-alt-text : Images should have alternate text (alt text) : https://github.com/DavidAnson/markdownlint/blob/v0.32.1/doc/md045.md
• MD051/link-fragments : Link fragments should be valid : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md051.md
• MD056/table-column-count : Table column counts should match : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md056.md

NOTE: the following ones are still remaining:

• MD001/heading-increment : Heading levels should only increment by one level at a time : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md001.md
  • The components documentation has jumps
  • TODO in follow-up: settle on one format
• MD013/line-length : Line length : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md013.md
  • We have not yet settled on a specific format
  • TODO in follow-up: settle on specific line length
• MD024/no-duplicate-heading : Multiple headings with the same content : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md024.md
  • The components documentation has multiply defined headings
  • TODO in follow-up: settle on one format

[mgovers]

Awaiting approval from the team (do-not-merge label)

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

The base branch was changed.

[mgovers]

I see that the PyPI job has not triggered yet on the current release v1.10.89. Awaiting resolution there

[mgovers]

Seems deeper and not something we can (re)solve automatically. I manually kicked off the publish pipeline to unblock this and other work. NOTE: we will need to do the same until a permanent solution is implemented