ci: Add markdown link checker to CI

[josedab]

Description

Documentation markdown files may contain broken links over time.

Task

• Add a CI job using lychee or markdown-link-check to verify links in *.md files
• Configure to ignore external URLs that require auth
• Add to the existing ci.yml workflow

Helpful Context

• lychee link checker
• Only check docs/, README.md, CONTRIBUTING.md